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Document Structure 

This manual introduces you to the RT-11 Version 5 software kit and tells you how to 
manually install your operating system. For those who automatically install their 
software, Chapter 2 of this guide provides useful information on customizing the 
distributed software. For those who cannot install their software automatically, the 
modular structure of this manual allows you to read only the chapters that you need 
for your combination of hardware and software. 

Chapter 1 of the manual introduces you to manual installation and system 
generation concepts and helps you choose a reading path through the other chapters. 

Installation concepts — both planning activities and actual installation procedures — 
are covered in Chapters 2 through 9. You should read Chapter 2 to plan your 
installation, then choose the chapter (3, 4, 5, 6, 7, 8, or 9) that describes the 
installation of a system most closely resembling your own configuration. 

Additional information available in the appendixes includes procedures to modify 
the MDUP utility to recognize unsupported or user written device handlers and 
toggle-in software bootstraps. 

If you discover that you need to perform the system generation process, refer to the 
RT-11 System Generation Guide. 

Before you begin, you should read the Guide to RT-11 Documentation, which 
describes the other software documents associated with the RT-11 operating system. 
Familiarity with the RT-11 system, as described in the Introduction to RT-11, is 
particularly helpful when you perform the procedures in this manual. 

If you are a FORTRAN, BASIC-PLUS, FMS-11, CTS-300, or other layered product 
user, you build your layered product system after building the RT-11 system. A 
layered product is software that is sold separately but requires the RT-11 operating 
system environment to run. See the appropriate installation manual for instructions 
on installing such products. 

Audience 

This manual is written for the RT-11 users who are going to install their system 
manually and/or customize an automatically installed system. 
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Conventions 

The following conventions are used in this guide. 



Convention 



Meaning 



Black print 



Red print 
Braces ({ }) 

Brackets ([ ]) 

lowercase 
characters 



Question 
marks 



UPPERCASE 
characters 



RET 



CTRL/X 



In examples, black print indicates output lines or prompting 
characters that the system displays. For example: 

.BACKUP/INITIALIZE DLO:F* .FOR DU1:WRK 
Mount output volume in DUl : ; continue? Y 

In examples, red print indicates user input 

In command syntax examples, braces enclose options that are 
mutually exclusive. You can choose only one option from the 
group of options that appear in braces. 

Square brackets in a format line represent optional parameters, 
qualifiers, or values, unless specified otherwise. 

In command syntax examples, lowercase characters represent 
elements of a command for which you supply a value. For 
example: 

DELETE filespec 

In the customization patches, question marks (?) are used to 
represent current values in a location. Those values cannot 
be anticipated and therefore cannot be included in the patch 
illustration. 

In command syntax examples, uppercase characters represent 
elements of a command that should be entered exactly as given. 

I RET I in examples represents the RETURN key. Unless 
the manual indicates otherwise, terminate all commands or 
command strings by pressing |RET| . 



I CTRL/x I indicates a control key sequence. While pressing the key 
labeled Ctrl, press another key. For example: |ctrl/c| 
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• Introduction to RT-11 
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Chapter 1 

Introduction 

Your first step in using RT-11 is to install it on your system. You can install RT-11 
automatically or manually, depending on your configuration. 

1.1 Manual and Automatic Installation 

You can install RT-11 automatically or manually. See the RT-11 Automatic 
Installation Guide to determine if you can automatically install RT-11. If your 
hardware does not support automatic installation, you must install RT-11 manually. 
Manual installation requires: 

• Bootstrapping and preserving the distribution volumes. 

• Creating the working system from selected components. 

• Optionally customizing the working system. 

• Preserving and testing the working system. 

Usually, your system is ready to run once you have installed and tested it. However, 
if you need certain special features, such as multiterminal support, you must perform 
the system generation process. In this case, run the SYSGEN program, answer its 
questions, and assemble your own generated monitor(s) and device handlers. See 
the RT-11 System Generation Guide for information about generating specialized 
monitors. 

The following sections help decide which course of action to take. Once you have 
established which steps you must complete, identify the chapters you need to read. 
You need not read this entire manual. 

1.2 Identifying Your Needs 

To select the procedures you must perform and the reading path to follow, use the 
information in this chapter to answer the following questions: 

• Can you automatically install your system? 

• What is your hardware configuration? 

• Which monitor(s) do you need? 

• Which features do you need? 
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1.2.1 Can You Automatically Install Your System? 

Look at the RT-11 Automatic Installation Guide to determine if you can install RT-11 
automatically. If possible, you should install RT-11 automatically unless you have a 
good reason for doing a manual installation. The automatic installation procedure 
is simple and it configures and tests your system automatically. 

If, according to the RT-11 Automatic Installation Guide, your system is supported 
for automatic installation, go now to that manual for directions. After automatically 
installing and configuring your system, return to this chapter for more installation 
information. 

If, according to the RT-11 Automatic Installation Guide, your system is not supported 
for automatic installation, continue reading this chapter and follow the appropriate 
reading path as defined in Table 1-3. 

1.2.2 What Is Your Hardware Configuration? 

Your hardware configuration is an important consideration for three reasons: 

• Installation procedures vary according to the hardware configuration. 

• System generation cannot be performed on all hardware configurations. 

• System generation procedures vary according to the hardware configuration. 

Chapters 3 through 9 contain detailed procedures for manually installing RT-11 
systems on certain common hardware configurations. Unless you have an unusual 
configuration, read only the chapter intended for your configuration. See Table 1-3 
to identify your reading path. 

1.2.3 Which Monitor(s) Do You Need? 

You have to decide which monitor or monitors you need to know what steps to follow 
in getting started. Your distribution kit includes the unmapped SB and FB monitors 
and the mapped XB, XM, ZB, and ZM monitors. 

Sections 1.2.3.1 and 1.2.3.2 describe the RT-11 monitors. More monitor information 
is located in the Introduction to RT-11. 

1.2.3.1 Unmapped (SB and FB) Monitors 

The unmapped monitors (SB and FB) are appropriate for processors that contain 
only kernel (64K bytes) memory. The SB monitor supports one job while the FB 
monitor supports a foreground and a background job. 

The SB monitor is the smallest RT-11 monitor. Use the SB monitor if your processor 
contains only 64K bytes of memory and your application is too large to run under 
the FB monitor. 

Use the FB monitor if your processor contains only 64K bytes of memory and 
your application will run in the available address space. The FB monitor allows 
you to execute an independent foreground job at a higher software priority level 
than the background, while you use the remaining system facilities to support the 
background. The RT-11 foreground job is not intended for a two-user time-sharing 
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system. Rather, it best supports a stable, event-driven real-time or I/O application 
that can execute with a minimum of user interaction while the bulk of the system's 
business is conducted in the background. 

The background in the foreground/background environment appears just like the SB 
monitor; all the facilities available to you as an SB user are available to you as an 
FB user in the background. 

1.2.3.2 Mapped (XB, XM, ZB, ZM) Monitors 

The mapped monitors are for processors that contain extended or mapped memory. 
Table 1-1 lists the basic characteristics. For more information on mapped monitors, 
see the Software Product Description (SPD) and the Introduction to RT-11. 

Table 1-1: Mapped Monitor Description 
Monitor Characteristics 

XB Single job. Does not support I & D (instruction and data) address space 

separation or Supervisor Mode 

XM Multiple jobs. Supports up to 8 concurrent jobs. Does not support I & D address 

space separation or Supervisor Mode 

ZB Single job. Supports I & D address space separation and Supervisor Mode 

ZM Multiple jobs. Supports up to 8 concurrent jobs, I & D address space separation 

and Supervisor Mode 

1.2.4 Which Features Do You Need? 

The characteristics of distributed software (monitors, utilities, and device handlers), 
are described in the Software Product Description (SPD), which is included with your 
documentation kit. You can change some characteristics of distributed software by 
using the customization patches listed in Table 1-2 and described in Chapter 2. If 
the distributed or customized software does not provide a feature you need, you must 
perform a system generation as described in the RT-11 System Generation Guide. 

1.2.4.1 Is Installation All You Need to Do? 

Decide whether installing the distributed software is all you need to do or whether 
you will also need to perform the system generation process. Table 1-2 summarizes 
the features you can add to your system by performing simple customizations during 
or after installation. Chapter 2 describes these software customizations in detail and 
provides instructions for implementing them. Many users will not need to make any 
of these customizations. 
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Table 1-2: Features Available Through Simple Software Customizations 



Feature 



Section Description 



Changing characters SRCCOM 2.6.1 
uses to indicate insertions and 
deletions 



Changing default output device 2.6.2 
from line printer to terminal 



Changing the LD handler suffix 2.6.3 
character 

Changing number of directory 2.6.4 
columns 



Changing default order of direc- 2.6.5 
tory listings 



Changing number of /Q p-sects 2.6.6 
LINK allows 



Changing size of LINK's library 2.6.7 
module list 



Changing size of QUEUE work 2.6.8 
file 



Normally, when you use the SRCCOM utility 
or DIFFERENCES/CHANGEBAR command 
to compare two files, SRCCOM uses the 
vertical bar character to indicate insertions 
and the bullet (alphabetic o) character to 
indicate deletions. You can modify SRCCOM 
to use different characters. 

If your configuration does not include a 
printer, you can change the default output 
device (which certain monitor commands 
use) from printer to terminal. To make this 
change, you can edit the start-up command 
file. 

You can change the LD handler suffix 
character (LDx) to anything other than X. 

When you use the DIRECTORY command, 
the directory prints in two columns. When 
you use the DIRECTORY/BRIEF command, 
the directory contains five columns with less 
information. You can modify DIR to change 
the default number of columns. 

By default, DIR lists a directory's contents 
by physical position. You can modify DIR to 
change the default to any one of five orders: 
creation date, file name, file size, file type, or 
position. 

You can modify LINK to change the number 
of absolute base-address p-sects that LINK 
allows. Normally, LINK's /Q option lets you 
specify the absolute base addresses of up to 
eight p-sects in your program. 

To change the default size of LINK's list of 
library modules, you can modify LINK. LINK 
normally creates a list of 2528 modules to 
be included from libraries during the link 
operation. If you are a DIBOL user, you must 
customize the software. 

You can modify QUEUE to change the size of 
the work file QUEUE uses to queue files to 
be sent to a device. If you increase the size of 
the work file, QUEUE can handle more files 
at one time. 
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Table 1-2 (Cont.): Features Available Through Simple Software Customizations 



Feature 



Section Description 



Modifying the EDIT utility 2.6.9 



Installing other devices 2.6.10 



Modifying BATCH to save space 2.6.11 



Modifying LINK to change de- 2.6.12 
fault SYSLIB device 



Modifying help text 



2.6.13 



If you have a terminal with nonstandard ES- 
CAPE code (that is, the terminal generates 
IVSg or 1768 rather than SSg), you must mod- 
ify EDITSAV so that it operates correctly. 

When you boot the system device, the 
bootstrap installs the devices in your 
hardware configuration if the appropriate 
device handler is on the system device and if 
there are enough slots. If you want to install 
a device that the bootstrap does not install, 
use the REMOVE and INSTALL commands. 
You can also: 

Change LP, LS, RK, DX, DY, DL, DM, or 
DU addresses: If any of these devices are 
installed at nonstandard CSR and vector 
addresses, you can use the monitor SET 
command to change the addresses. 

Install hardware magtape: If you need hard- 
ware magtape support, you must perform 
a system generation and then rename the 
hardware handler to MM.SYS, MTSYS, MS.SYS, 
or MU.SYS (or the mapped versions with an 
X suffix). 

Set magtape parity and density: If you need 
to set magtape parity or density to other than 
the standard 800 bits/in, odd parity, you can 
use the monitor SET command for TMll or 
TJU16 magtape (but not TSll). 

If (after performing the system generation 
procedure and including BATCH support) 
you need to save disk space, you can store 
certain system programs on DK rather than 
on SY and cause BATCH to access them 
there. Modify BATCH so that it invokes 
system programs with the monitor RUN 
command (which assumes DK as the default) 
rather than with the R command (which 
always uses SY). 

By customizing the linker, you can change 
the device on which the default system 
library, SYSLIB.OBJ, resides. 

To change the help text that prints when you 
use the HELP command, you must create 
your own help text file, process that text file 
with LIBR, and copy the resulting library 
and the file HELPEXE to the same volume. 
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Table 1-2 (Cont.): Features Available Through Simple Software Customizations 



Feature 



Section Description 



Preventing fatal system errors 2.6.14 
from causing a reset 



Running RT-11 in less memory 2.6.15 
than is available 



Setting VTCOM default dial 2.6.16 
string 

Setting upper limit on file size 2.6.17 



Changing the number of bad 2.6.18 
blocks that BUP accepts 



Changing the default file type 2.6.19 
extension of IND control files 



Setting upper limit on memory 2.6.20 
size 



Suppressing bootstrap message 2.6.21 



Suppressing start-up indirect 2.6.22 
command file 



Suppressing start-up indirect 2.6.23 
command file echo 



Changing bootstrap message 2.6.24 



Changing default device for 2.6.25 
indirect command files 



You can customize the monitor to prevent it 
from performing a hard reset of errors when 
a fatal system error occurs. The normal 
reset stops I/O, protecting media from being 
corrupted. Some hardware errors may be 
more easily diagnosed without this reset. 

You can customize your software if your 
application requires that RT-11 run in less 
memory than is available. 

You can modify VTCOM to set a default 
string for the DIAL command. 

If your application requires an upper limit to 
the size of a file, you can change the monitor 
to set the limit you require. 

If you want BUP to handle more than 25 bad 
blocks on the input device, change BUP to 
accept and process as many as you specify. 

You can change the default IND file type 
extension from .COM to whatever you 
specify. 

If your PDP-11 does not generate a bus 
timeout trap, RT-11 does not load into 
memory properly. You can alter the monitor 
to cause the bootstrap to never look for more 
than 28K words of memory. 

If you want to prevent the monitor identifi- 
cation message from printing when you boot- 
strap a monitor, you can modify that monitor. 

If you want to prevent the start-up command 
file from executing when you bootstrap a 
monitor, you can modify that monitor. 

If you want the start-up indirect command 
file to execute when you bootstrap a monitor 
but you do not want the command lines in 
the file to echo (appear) on the terminal, you 
can modify the monitor. 

If you want to change the monitor identifi- 
cation message that appears when you boot- 
strap a monitor, you can modify that monitor. 

If you want to change the default device for 
indirect command files, you can modify the 
monitor. Normally, the monitor looks for the 
command file on DK:. 
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Table 1-2 (Cont.): Features Available Through Simple Software Customizations 



Feature 



Section Description 



Changing default file type for 2.6.26 
indirect command files 



Changing default device for 2.6.27 
FRUN command 



Changing default file type for 2.6.28 
FRUN command 



Changing default device for 2.6.29 
EDIT utility command 



Changing default file name for 2.6.30 
EDIT command 



Using Examine and Deposit 2.6.31 
above background job 



Changing default device for 2.6.32 
QUEMAN 



Changing indirect command file 2.6.33 
nesting depth 



If you want to change the default file type for 
indirect command files, you can modify the 
monitor. Normally, indirect command files 
have the default file type .COM. 

If you want to change the default device for 
the FRUN command, you can modify the 
monitor. Normally, the monitor looks for the 
foreground program on device DK: when you 
type FRUN filnam. 

If you want to change the default file type 
for the FRUN command, you can modify the 
monitor. Normally, the default file type for 
foreground programs is .REL. 

If you want to change the default device for 
the EDIT command with EDITSAV, you can 
modify the monitor. Normally, the monitor 
looks for the hard-copy editor file EDITSAV 
on device SY. 

If you want the monitor to run an editor 
other than the default editor when you type 
the EDIT command, you can modify the 
monitor to change the file name of the default 
editor. 

If you want to be able to examine and 
modify the monitor and the I/O page, you 
can customize the monitor to remove a 
restriction on the use of the examine (E) 
and deposit (D) commands. Normally, the 
monitor allows you to examine and modify 
only locations inside the background job's 
area. 

If you want to send a file to a device other 
than LP when you use the PRINT command 
in an FB system (with QUEUE running as a 
foreground job), you can modify the monitor 
to change the default. This modification also 
changes the default for the DELETE/ENTRY 
command. 

If you want to change the depth to which 
you can nest indirect command files, you 
can modify the monitor. Normally, RT-11 
allows you to nest indirect command files 
three deep. 
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Table 1-2 (Cont.): Features Available Through Simple Software Customizations 



Feature 



Section Description 



Changing threshold for resum- 2.6.34 
ing output-stalled jobs 



Changing default number of 2.6.35 
directory segments 



Changing width of banner pages 2.6.36 
from 132 to 80 columns 



Modifying listing page length in 2.6.37 
LINK 



Assigning HELP file 



Replacing bad blocks 



2.6.38 



Changing device from which 2.6.39 
IND is run 



2.6.40 



Including user-written magtape 2.6.41 
handler 

Eliminating or changing the 2.6.42 
IND control file terminating 
message 

Changing default file type of 2.6.43 
logical disk files 



Changing QUEUE to allow first 2.6.44 
form feed 

Changing listing page length in 2.6.45 
MACRO and CREF 

Changing default command file 2.6.46 
processor to IND 



If you have a foreground job that produces 
much terminal output and stalls frequently 
(waiting for room in the terminal output 
buffer), you can modify the monitor to 
improve throughput. 

If you want DUP to use a different default 
number of directory segments when you 
initialize volumes, you can modify DUP. 
DUP normally uses the number of directory 
segments specified in a table in DUP. 

If you want to change the width of banner 
page printouts from 132 to 80 columns, you 
can modify QUEUE. 

If your line printer uses paper that is not 
10.5 inches long, or if you do not have a 
line printer, you can modify LINK to change 
the listing page length from the standard 60 
lines. 

You can modify the monitor to assign your 
HELP file to a file or device other than 
SY:HELPSAV. 

You can modify the monitor to change the 
device from which IND is run. 

You must customize DUP if your user- 
written device handler supports bad block 
replacement. One change is required to 
replace all bad blocks, another to replace 
only bad sectors. 

You must customize DUP, PIP, and MDUP if 
you use a user-written magtape handler. 

You can eliminate or change the terminating 
message of IND control files. 



You can change the default file type of 
logical disk files from .DSK by modifying 
either the LD.SYS file or the conditional file 
SYSGEN.CND. 

You can modify QUEUE to never suppress 
the initial form feed in a file. 

You can change the default (60 lines) page 
listing length for MACRO and CREF. 

You can change the monitor command file 
processor from KMON to IND. 
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Table 1-2 (Cont.): Features Available Through Simple Software Customizations 



Feature 



Section Description 



Limiting amount of memory 2.6.47 
KEX requests 

Changing MACRO'S default .LIST 2.6.48 
/.NLIST options 

Changing MACRO'S default .EN- 2.6.49 
ABLE/.DISABLE options 

Modifying KED default file type 2.6.50 

Changing SPO OL's work file size 2.6.51 

Changing SPOOL'S output device 2.6.52 

Changing LINK's default map 2.6.53 
and table output to 132 columns 



Changing default size of MACRO- 2.6.54 
11 work file 



Changing name and default 2.6.55 
device for UCL.DAT 

Suppressing dynamic allocation 2.6.56 
of a region for IND 



ChangingsizeofUCL.DAT 2.6.57 



Changing default VTCOM send 2.6.58 
speed 

Modifying system macro library 2.6.59 
SYSMAC.SML 

Modifying VTCOM default dial 2.6.60 
string prefix 

Modifying VTCOM default dial 2.6.61 
string suffix 

Automatically creating KED/KEX 2.6.62 
journal files 



Adjusting default KED/KEX jour- 2.6.63 
nal file size allocation 



You can reduce memory requested by KEX 
from the default 32KW to your requirements 
by using the .SETTOP programmed request. 

You can change the default options for the 
.LIST/.NLIST macros. 

You can change the default options for the 
.ENABLE/.DISABLE macros. 

You can change the KED default file type. 

You can change the size of SPOOL'S work file. 

You can change SPOOL'S default output 
device. 

You can change LINK's default link map and 
global cross-reference table output to 132 
columns. 

You can change the default size of MACRO- 
ll's work file to a value from 128 lo to a 
maximum of 256io blocks. 

You can change the name and default device 
for UCL.DAT. 

You can suppress IND's dynamic allocation of 
a region in extended memory for its symbol 
table. 

You can change the maximum number of 
user-defined UCL commands from 31io to a 
maximum you specify. 

You can change the default VTCOM send 
speed to FAST if the host terminal service 
supports XON/XOFE 

You can modify the system macro library by 
running the SPLIT utility 

You can modify the VTCOM default dial 
string prefix. 

You can modify the VTCOM default dial 
string suffix. 

You can cause the keypad editor to automat- 
ically open and write a journal file at each 
editing session. 

You can change the number of blocks 
allocated by the keypad editor on the default 
journal file device. 
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Table 1-2 (Cont.): Features Available Through Simple Software Customizations 



Feature 



Section Description 



Creating a monitor-independent 2.6.64 
ODT debugger 

Forcing an explicit KED/KEX 2.6.65 
journal file device 

Modifying the storage capacity 2.6.66 
for LEARN macros 



Modifying the maximum num- 2.6.67 
ber of LEARN macros 



Restoring LOCAL form feed 2.6.68 
processing 

Removing the JSW bit 6 check 2.6.69 
forSL 



Changing SL character edit 2.6.70 
mode to REPLACE 



Changing the VTCOM command 2.6.71 
mode character 



Forcing obsolete SJ monitor 2.6.72 
value in CONFIG bit $FBMON 



Making LINK /G option a de- 2.6.73 
fault 



Changing the default magtape 2.6.74 
label size 



You can create an ODT variant that does not 
require that the operating system be loaded 
in memory. 

You can force the default journal file device 
to be other than DK. 

You can modify the amount of storage 
capacity (in memory) that the keypad editor 
allocates for LEARN macro storage. 

By default, the keypad editor allows the 
definition of 8io LEARN macros at one time. 
You can modify that limit. 

You can restore the recognition of form 
feeds in files being processed by the LOCAL 
keypad editor feature. 

The single-line editor (SL) checks bit 6 of the 
Job Status Word before editing a command 
line. You can remove that bit check. 

SL can edit single characters in two modes: 
REPLACE and INSERT. You can change 
the default edit mode from INSERT to 
REPLACE. 

You can change the character you type 
to VTCOM to enter command mode from 
CTRL/P to one you specify. 

You can change the default value of the 
$FBMON bit in the CONFIG word from set 
to clear, if required, to load handlers that 
require a clear $FBMON bit. 

You can make the /G option a default 
whenever LINK is run. The /G option is 
not available under DCL; you can use this 
customization to include that option when 
issuing LINK commands under DCL. 

The current magtape label size is 80 lo bytes. 
If you need to change that size to some 
other value, use this customization. (80 byte 
labels are required for any magtape that will 
be subsequently read by the VMS operating 
system.) 
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1 .2.4.2 Do You Need to Perform the System Generation Procedures? 

You must perforin the system generation procedures if you want to add to your 
system any features that are not included in the distributed software or hsted in 
Table 1-2. You may also need to perform the system generation procedures if you 
want to remove features to reduce the size of the monitor and improve response 
time. Refer to the system generation dialog and the descriptive text in the RT-11 
System Generation Guide further information about these features. 

1.3 Choosing a Reading Path 

You only need to read the chapters that pertain to your configuration. Table 1-3 
gives you the information you need to select these chapters. 

NOTE 

If you are unfamiliar with RT-11 software, you should 
probably use the distributed monitors uncustomized 
for a while. Once you have gained familiarity with 
the system, you will be better equipped to perform 
customizations or system generation procedures. Be 
aware, however, that some customizations may 
be essential for your particular application, and, 
consequently, you may experience problems when you 
use software without needed support. If you are an 
inexperienced user, be sure to study Table 1-2, but you 
may want to delay making any customizations until you 
have gained more experience with RT-11. Further, be 
sure to read the Introduction to RT-11 before using RT- 
11 for any critical applications. 



Table 1-3: Chapters You Should Read 



If Your Distribution 
Medium is: 



And if Your System De- 
vice on Target System 



is: 



Then Read Chapters: 



Single-Density Diskette 
RXOl 



Single-Density Diskette 
Hard Disk 

RLOl 
RL02 
RK05 
RK06 
RK07 



1,2,3 
1,2,4 
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Table 1-3 (Cont.): Chapters You Should Read 



If Your Distribution 
Medium is: 


And if Your System De- 
vice on Target System 
is: 


Then Read Chapters: 


Hard Disk 


Hard Disk 


1,2,5 


RL02 


RLOl 
RL02 
RK05 
RK06 
RK07 
RC25 






Single-Density or Double- 
Density Diskette 


1,2,6 


Double-Density Diskette 


Double-Density Diskette 


1,2,7 


RX02 


RX02 




Magtape 


Hard Disk 


1,2,8 


9-track, 1600 bpi 
TMSCP 


RLOl 
RL02 
RK05 
RK06 
RK07 




Diskette RX50 








Professional 350/380 
MSCP disk 


1,2,9 

Use Automatic Installation Pro- 
cedure 
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Chapter 2 

Preparing for Installation 



You should take the following steps before you begin to install your system: 

1. Decide on automatic or manual installation. 

2. Survey the general installation procedures. 

3. Study the contents of your software kit. 

4. Select the components you need in your working system. 

5. Plan the arrangement of components. 

6. Choose the software customizations you need to make. 

2.1 Deciding on Automatic or Manual Installation 

If you are uncertain as to whether your hardware configuration supports automatic 
installation, see the RT-11 Automatic Installation Guide for information. In general, 
if your hardware configuration supports automatic installation, you should install 
your software distribution using that method and return to Section 2.6 of this 
chapter. 

If your hardware configuration supports automatic installation, install your 
distribution using that method. The remainder of this chapter provides information 
you might find useful however you install your software. You can, however, safely 
ignore the information in this manual that follows this chapter. 

2.2 Surveying Installation Procedures 

Although the specific steps you must perform to install RT-11 depend on your 
configuration, all users must perform some general procedures. 

First, you must bootstrap the distribution volume and preserve the volume (or 
volumes) by making backup copies. You then automatically or manually create 
the working system from chosen components (eliminating components you do not 
need) and install the bootstrap on the working system volume(s). At this point, 
you can make software customizations which do not require performing the system 
generation process. When you have customized the system, you should compress the 
working system volume or volumes and preserve them on backup volumes. Once you 
are satisfied with the working system you have created, you should test it to make 
sure that it works properly. 
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2.3 Studying Software Kit Contents 

Study Table 2-1 for a summary of the RT-11 components distributed in the kits, 
and refer to the RT-11 System Utilities Manual for a thorough description of each 
utihty. RT-11 is distributed on an RL02 disk, on RXOl, RX02, and RX50 diskettes, 
and on reel and cartridge magtape. The organization of files on volumes depends on 
the distribution medium. 

Table 2-1: RT-11 Software Components 



Type of Software 



Description 



Monitors 

RTllAI.SYS 
RTllMT.SYS 

RTllSB.SYS 
RTllFB.SYS 
RTllXB.SYS 

RTllXM.SYS 
RTllZB.SYS 

RTllZM.SYS 
Device Handlers 

DL.SYS 

DLX.SYS 

DM. SYS 

DMX.SYS 

DU.SYS 

DUX.SYS 

DW.SYS 

DWX.SYS 

DX.SYS 

DXX.SYS 
DYSYS 



Automatic installation monitor 

Magtape monitor used only to build MDUP.xx for user-supplied 
(not distributed) device handler 

Unmapped single-job monitor 

Unmapped foreground/background monitor 

Mapped extended memory single-job monitor; 

not distributed — must be built by SYSGEN from distributed 

answer file 

Mapped extended memory monitor 

Fully-mapped extended memory single-job monitor; 

not distributed — must be built by SYSGEN from distributed 

answer file 

Fully-mapped extended memory monitor 



RL11/RL01/RL02 handler for unmapped monitors 

RL11/RL01/RL02 handler for mapped monitors 

RK611/RK06/RK07 handler for unmapped monitors 

RK611/RK06/RK07 handler for mapped monitors 

MSCP device handler for unmapped monitors 

MSCP device handler for mapped monitors 

Professional 300 series processor disk handler for unmapped 
monitors 

Professional 300 series processor disk handler for mapped 
monitors 

RXll/RXOl single-density diskette handler for unmapped 
monitors 

RXll/RXOl single-density diskette handler for mapped monitors 

RX211/RX02 handler for unmapped monitors 
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Table 2-1 (Cont.): RT-11 Software Components 



Type of Software 



Description 



DYX.SYS 

DZ.SYS 

DZX.SYS 

LD.SYS 

LDX.SYS 

LP. SYS 

LPX.SYS 

LS.SYS 

LSX.SYS 

MM.SYS 

MMX.SYS 

MS.SYS 

MSX.SYS 

MT.SYS 

MTX.SYS 

MU.SYS 

MUX.SYS 

NCX.SYS 

NL.SYS 

NLX.SYS 

NQX.SYS 

NUX.SYS 

PI.SYS 

PIX.SYS 

RK.SYS 

RKX.SYS 

SPSYS 

SPX.SYS 

UBX.SYS 



RX211/RX02 handler for mapped monitors 

Professional 300 series diskette handler for unmapped monitors 

Professional 300 series diskette handler for mapped monitors 

Logical disk subsetting handler for unmapped monitors 

Logical disk subsetting handler for mapped monitors 

Parallel interface printer handler for unmapped monitors 

Parallel interface printer handler for mapped monitors 

Serial interface printer handler for unmapped monitors 

Serial interface printer handler for mapped monitors 

File -structured TJU16 handler for unmapped monitors 

File -structured TJU16 handler for mapped monitors 

File -structured TSll handler for unmapped monitors 

File -structured TSll handler for mapped monitors 

File -structured TMll handler for unmapped monitors 

File -structured TMll handler for mapped monitors 

File -structured TMSCP handler for unmapped monitors 

File -structured TMSCP handler for mapped monitors 

Ethernet handler for Professional 300 series processors 

Null handler for unmapped monitors 

Null handler for mapped monitors 

Ethernet handler for Q-Bus processors 

Ethernet handler for UNIBUS processors 

Professional 300 series processor interface system support 
handler for unmapped monitors 

Professional 300 series processor interface system support 
handler for mapped monitors 

RK11/RK05 handler for unmapped monitors 

RK11/RK05 handler for mapped monitors 

Transparent print spooler handler for unmapped monitors 

Transparent print spooler handler for mapped monitors 

UNIBUS mapping register system support handler for mapped 
monitors 
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Table 2-1 (Cont.): RT-11 Software Components 



Type of Software 



Description 



VM.SYS 

VMX.SYS 

XC.SYS 

XCX.SYS 

XL. SYS 

XLX.SYS 

Other System Files 

SL.SYS 

SLMIN.SYS 

SLX.SYS 

SWAP.SYS 

Utility Programs 

BINCOM.SAV 

BUP.SAV 

CREF.SAV 

DIR.SAV 

DUMP.SAV 

DUP.SAV 

EDIT.SAV 

FILEX.SAV 

FORMAT. SAV 

GIDIS.SAV 

HELP SAV 

IND.SAV 

INDEX.SAV 

INDEXX.SAV 

KED.SAV 

KEX.SAV 

LIBR.SAV 



Virtual disk handler for unmapped monitors 

Virtual disk handler for mapped monitors 

Professional 300 series processor communication port modem 
handler for unmapped monitors 

Professional 300 series processor communication port modem 
handler for mapped monitors 

DL-11 communication port modem handler for unmapped 
monitors 

DL-11 communication port modem handler for mapped monitors 



Single-line editor pseudohandler for unmapped monitors 
Minimal single-line editor pseudohandler 
Single-line editor pseudohandler for mapped monitors 
External monitor swap blocks 

Binary compare utility 

Backup utility 

Cross-reference utility 

Directory utility 

File dump utility 

Disk utility 

Text editor 

Foreign file exchange utility 

Disk formatting utility 

Graphics utility for Professional 300 series processors 

Help utility 

Indirect control file processor 

On-line index utility 

Virtual memory on-line index utility 

Keypad editor 

Virtual memory keypad editor 

Librarian 
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Table 2-1 (Cont.): RT-11 Software Components 



Type of Software 



Description 



LINK.SAV 

MACRO.SAV 

MDUP.AI 

MDUP.MM 

MDUP.MS 

MDUP.MT 

MDUPMU 

MDUPSAV 

MONMRG.SAV 

MSCPCK.SAV 

PAT.SAV 

PIPSAV 

QUEMAN.SAV 

QUEUE.REL 

RESORC.SAV 

SETUPSAV 

SIPPSAV 

SLPSAV 

SPOOL.REL 

SPOOL.SAV 

SRCCOM.SAV 

TRANSESAV 

UCL.SAV 

VTCOM.REL 

VTCOM.SAV 

Miscellaneous 

BATCH.SAV 

ERROUT.SAV 

INDEX.IDX 



Linker 

MACRO assembler 

Magtape bootstrap utility for TMSCP auto installation 

Magtape bootstrap utility for TJU16 

Magtape bootstrap utility for TSll 

Magtape bootstrap utility for TMll 

Magtape bootstrap utility for TMSCP 

Magtape utility 

System generation monitor linking program 

Q-bus revision level checking program for MSCP and TMSCP 
devices 

Patching utility for program object modules 

File transfer utility 

User interface with QUEUE utility 

Device queue utility 

System resource display utility 

VTIOO and Professional 300 series processor terminal setup 
utility 

Save image patch utility 

Source language patch utility 

Transparent print spooler utility 

Virtual memory tranparent print spooler utility 

Source compare utility 

RT-11 host file transfer program for VTCOM 

User command linkage executable image 

Virtual terminal communication and file transfer utility 

Virtual version of VTCOM communication utility, for running 
under mapped monitors 

BATCH processor 

Error log display program 

Index pointer file for INDEX utility 
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Table 2-1 (Cont.): RT-11 Software Components 



Type of Software 



Description 



INDEXA.IMG 

INDEXB.IMG 

MSB.COM 

MTB.COM 

MUB.COM 

RTFB.MAP 

RTSB.MAP 

RTXB.MAP 

RTXM.MAP 

RTZB.MAP 

RTZM.MAP 

STRTFB.COM 

STRTSB.COM 

STRTXB.COM 

STRTXM.COM 

STRTZB.COM 

STRTZM.COM 

V5USER.TXT 

System Generation Files 

SYSGEN.COM 

SBFB.ANS 

XB.ANS 

XM.ANS 

XMEL.ANS 

ZB.ANS 

ZM.ANS 

Automatic Installation 
Files 



First half of INDEX utility index file 
Second half of INDEX utility index file 
MS type magtape distribution build file 
MM/MT type magtape distribution build file 
MU type magtape distribution build file 
Distributed FB monitor link map 
Distributed SB monitor link map 
Distributed XB monitor link map 
Distributed XM monitor link map 
Distributed ZB monitor link map 
Distributed ZM monitor link map 
FB start-up command file 
SB start-up command file 
XB start-up command file 
XM start-up command file 
ZB start-up command file 
ZM start-up command file 
Distribution kit message text file 

SYSGEN command file 

Answer file to build distributed unmapped monitors 

Answer file to build distributed XB monitor 

Answer file to build distributed XM monitor 

Answer file to build distributed XM monitor with MSCP error 
logging support 

Answer file to build distributed ZB monitor 

Answer file to build distributed ZM monitor 



IVPMAC 

STRTAI.COM 

TERMID.SAV 



Automatic installation verification source file 
Start-up file for automatic installation 
Console terminal identification program 
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Table 2-1 (Cont.): RT-11 Software Components 



Type of Software 



Description 



VERIFY.COM 
Debuggers 

DBGSYM.SAV 

ODT.OBJ 

SDH.SYS 

SDHX.SYS 

SDS.SYS 

SDSX.SYS 

VDT.OBJ 

Graphics Software 

ALPHOO.FNT 

Libraries and Subrou- 
tines 

EDTL.MLB 

SYSLIB.OBJ 

SYSMAC.SML 

SYSTEM.MLB 

Bootstraps 

MBOOT.BOT 

MB0T16.B0T 

MSBOOT.BOT 

Demonstration Programs 

DEMOB l.BAS 

DEMOBG.MAC 

DEMOFG.MAC 

DEMOFl.FOR 

DEM0F2.F0R 

DEM0F3.F0R 

DEMOKD.TXT 

DEMOMl.MAC 



Automatic installation verification command file 

DBG-11 symbol table utility 

Debugging aid 

DBG-11 unmapped hardware I/O pseudohandler 

DBG-11 mapped hardware I/O pseudohandler 

DBG-11 unmapped software I/O pseudohandler 

DBG-11 mapped software I/O pseudohandler 

Debugging aid for virtual and multiterminal jobs 

PRO GIDIS font table 



Common monitor definitions 
System-callable subroutines 
System macro library 
System-callable data structure macros 

Magtape primary bootstrap for TMSCP and 800 bits/in tape 
Magtape primary bootstrap for 1600 bits/in tape 
Magtape secondary bootstrap 

Demonstration source — BASIC-PLUS program 
Demonstration source — SB/FB macro program 
Demonstration source — FB macro program 
Demonstration source — FORTRAN program 
Demonstration source — FORTRAN program 
Demonstration source — FORTRAN program 
Keypad editor demonstration source 
Debugging demonstration source 
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Table 2-1 (Cont.): RT-11 Software Components 



Type of Software 



Description 



Source Files 

BA.MAC 

BSTRAP.MAC 

DL.MAC 

DM.MAC 

DU.MAC 

DW.MAC 

DX.MAC 
DY.MAC 
DZ.MAC 

EDTG.MAC 

EL.MAC 

ELCOPY.MAC 

ELINIT.MAC 

ELTASK.MAC 

ERROUT.OBJ 

ERRTXT.MAC 

FB.MAC 

FSM.MAC 

KMON.MAC 

KMOVLY.MAC 

LD.MAC 

LP.MAC 

LS.MAC 

MTTEMT.MAC 

MTTINT.MAC 
NC.MAC 

NI.MAC 



BATCH handler source file for system generation 

Bootstrap source file for system generation 

RLOl/02 handler source file for system generation 

RK06/07 handler source file for system generation 

MSCP device handler source file for system generation 

Professional 300 series processor disk handler source file for 
system generation 

RXOl handler source file for system generation 

RX02 handler source file for system generation 

Professional 300 series processor diskette handler source file for 
system generation 

Monitor edit log and global definition file for system generation 

Error logger handler source file for system generation 

Error log job source file for system generation 

Error log job source file for system generation 

Error log job source file for system generation 

Error log job file for system generation 

Error log job source file for system generation 

FB conditional source file for system generation 

Magtape file support source file for system generation 

Keyboard monitor source file for system generation 

Keyboard monitor overlay source file for system generation 

Logical disk subsetting handler source file for system generation 

Parallel interface printer handler source file for system 
generation 

Serial interface printer handler source file for system generation 

Multiterminal programmed request source file for system 
generation 

Multiterminal interrupt service source file for system generation 

Ethernet port handler source file for system generation for 
Professional 300 series processors (DECNA controller) 

Ethernet class handler source file for system generation 



2-8 RT-11 Installation Guide 



Table 2-1 (Cont.): RT-11 Software Components 



Type of Software 



Description 



NL.MAC 
NQ.MAC 

NU.MAC 

RK.MAC 

RMON.MAC 

SP.MAC 

TJ.MAC 

TM.MAC 

TRMTBL.MAC 

TS.MAC 

TT.MAC 

TU.MAC 

UM.MAC 

USR.MAC 

VM.MAC 

XB.MAC 

XC.MAC 

XL.MAC 

XM.MAC 

XMSUBS.MAC 

ZB.MAC 

ZM.MAC 

Unsupported Software 

CONFIG.SAV 

C0NFIG.COM 

CONSOL.MAC 

CUSTOM.TXT 

DATIME.MAC 



Null handler source file for system generation 

Ethernet port handler source code file for system generation for 
Q-bus processors (DEQNA and DELQA controllers) 

Ethernet port handler source code file for system generation for 
UNIBUS processors (DEUNA and DELUA controllers) 

RK05 handler source file for system generation 

Resident monitor source file for system generation 

Transparent print spooler handler source file for system 
generation 

TJU16 handler source file for system generation 

TMll handler source file for system generation 

Multiterminal table source file for system generation 

TSll handler source file for system generation 

TT.SYS source file for system generation 

TMSCP handler source file for system generation 

MSCP (and TMSCP) handler source file for system generation 

USR source file for system generation 

VM.SYS source file for system generation 

XB conditional file for system generation 

Professional 300 series processor communication port modem 
handler source file for system generation 

DL-11 communication port modem handler source file for system 
generation 

XM conditional source file for system generation 

Mapped monitor subroutines for system generation 

ZB conditional file for system generation 

ZM conditional file for system generation 

Automatic system software configuration services program 

Automatic system software configuration command file 

Change boot-time console terminal 

Customization symbol location file 

Date and time source file for system generation 
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Table 2-1 (Cont.): RT-11 Software Components 



Type of Software Description 



DATIME.SAV Date and time utility 

NITEST.MAC Ethernet test source file 

RTMON.REL System activity monitor 

SPLIT. SAV File split utility 

TRANSF.EXE VAXA^MS host file transfer program for VTCOM 

TRANSF.TSK RSX host file transfer program for VTCOM 

V5N0TE.TXT RT-11 release notes addenda 

VBGEXE.SAV Virtual RUN utility 



2.4 Selecting Components for Your Working System 

How you select components for your working system is largely determined by 
whether you have a larger (disk) or a smaller (diskette) system device. 

2.4.1 Components for Larger (Disk) System Devices 

If you have a disk system device, you can store all usable system files on one device 
and the single system device is your working system. Any of the disk devices contains 
enough storage capacity for all appropriate system files. RT-11 distributes a variety 
of system files and all are not needed on any one computer system. So, RT-11 
provides a configuration program, C0NFIG.COM, you can run to automatically 
delete all unneeded system files. Further, although certain system files could 
be used on your computer system, if you know you will not use them, you can 
manually delete them after running CONFIG. The CONFIG program is included in 
the automatic installation procedure. If you are installing your software distribution 
manually, after completing the installation, issue the following command and follow 
the prompts: 

.$@CONFIG [r13 

Then examine your directory: 

.DIRECTORY/FULL SY: [Rfr] 

If ample space remains unused on your system volume, you are done. You have 
created your working system. 

If the remaining storage space on your system device is limited, use the information 
in Table 2-1 to determine which files can be deleted manually. Delete those files. 
You have then created your working system. 
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2.4.2 Components for Smaller (Diskette) System Devices 

If you have a diskette system device, you must be selective and perhaps only place 
system files for a particular application on each of several working systems; one 
for each application. To decide which components these should be, study the space 
limitations of your device, then consider the suggestions given for each software 
component (Sections 2.4.2.1 through 2.4.2.13). 

Before selecting components, you should become familiar with your medium's space 
limitations. (See Table 2-2.) Establish how many blocks are occupied by the 
components residing on each volume and how much free space is available on the 
volume. 



Table 2-2: Device Size 



Device 



Device Name Size in Blocks 



RXOl Diskette 


DX 


486 


RX02 Diskette 


DY 


974 


RX50 Diskette 


DU,DZ 


786 


Virtual Memory 


VM 


Vari 



Variable, depending on physical memory 
available 



Keep in mind the number of blocks components occupy when you select the 
components for your working system. Also, keep them in mind when you decide 
how to arrange these components on volumes. Remember that you may need space 
for data storage on your system volume and other volumes in the working system. 

Although you will probably find it more efficient to select components for the working 
system before actually starting installation, you can also examine volume directories 
during the installation process to get the component size information. Once you have 
booted the system, begun the installation process, and backed up the distribution 
media, you can examine a backup volume's directory (or the directories of each 
backup volume if there are more than one). Use the DIRECTORY command to 
examine a directory. The following is a sample directory. 



15-Mar-90 














SWAP 


.SYS 


28P 


16-Jan-90 


RTllXM 


.SYS 


123P 


16-Jan-90 


VMX 


.SYS 


3 


14-Apr-89 


PIX 


.SYS 


68P 


16-Jan-90 


DWX 


.SYS 


6P 


16-Jan-90 


DZX 


.SYS 


4P 


16-Jan-90 


LSX 


.SYS 


5P 


16-Jan-90 


SPX 


.SYS 


IIP 


16-Jan-90 


XCX 


.SYS 


4P 


16-Jan-90 


LDX 


.SYS 


IIP 


16-Jan-90 


SLX 


.SYS 


2 OP 


16-Jan-90 


DUP 


.SAV 


52P 


16-Jan-90 


DIR 


.SAV 


2 OP 


16-Jan-90 


PIP 


.SAV 


30P 


16-Jan-90 


KEX 


.SAV 


72P 


16-Jan-90 


VTCOM 


.SAV 


24P 


16-Jan-90 


SPOOL 


.SAV 


22P 


16-Jan-90 


DUMP 


.SAV 


lOP 


16-Jan-90 


SETUP 


.SAV 


42P 


16-Jan-90 


RESORC 


.SAV 


33P 


16-Jan-90 


UCL 


.SAV 


16P 


16-Jan-90 


UCL 


.DAT 


9 


09-Jan-89 


VBGEXE 


.SAV 


16P 


16-Jan-90 


SRCCOM 


.SAV 


26P 


16-Jan-90 


STARTX 


.COM 


2 


13-Feb-90 










25 FilBS, 


657 Blocks 










634 Free blocks 
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You can also find the total free space on an initialized blank volume by obtaining a 
directory of the volume. 

Once you have examined the software kit maps, read the following sections to help 
you make your selections. The following elements are described: 

Monitor 

SWAP.SYS File 

System Device Handler 

Other Device Handlers 

Default System Library 

Help Package 

Printer Handlers 

MACRO-11 Assembler 

Queue Package 

Source Files 

Start-Up Command File 

Text Editors 

Utility Programs 

2.4.2.1 Monitor 

In general, you need only one monitor on a working system. If you do need more 
than one monitor, build a different system volume for each monitor. When your 
system device is a large disk, you may have room for several monitors. 

2.4.2.2 SWAP.SYS File 

You need the file SWAP.SYS on a system volume to serve as temporary storage for 
part of a program in memory when KMON, the USR, or both must swap over that 
program. When KMON or the USR are no longer needed, the system reads this 
external swap file back into main memory. The keyboard command, SET EXIT 
NOSWAP, precludes the necessity of using SWAP.SYS once you have bootstrapped 
the system. However, you must have the SWAP.SYS file on your distribution disk to 
bootstrap your system successfully. 

2.4.2.3 System Device Handler 

You need a system device handler on each system volume. For example, if you build 
an FB system with RL02 as the system device, the file DL.SYS must be on the 
system disk. 
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2.4.2.4 Other Device Handlers 

In addition to the system device handler, you need the device handlers for the other 
peripheral devices in your configuration. You do not need handler files for any devices 
you do not have. 

2.4.2.5 Default System Library 

To use the LINK utility program, you may need the file SYSLIB.OBJ, the default 
system library, which the RT-11 linker searches to resolve any undefined globals at 
the end of a linking operation. 

Generally, SYSLIB for your application should contain the system subroutines 
(the file SYSLIB.OBJ found in the software kit), installation-specific libraries of 
application subroutines, and the FORTRAN OTS routines. If SYSLIB must contain 
application subroutines and language routines, you must customize it to include 
these routines. If you intend to link overlaid files, you need SYSLIB, because it 
contains the overlay handlers. See the RT-11 System Utilities Manual for more 
information on LINK and overlays. 

2.4.2.6 Help Package 

HELP.SAV consists of HELP.EXE and HELP.MLB (resulting file after the librarian, 
LIBR, processes HELP.TXT) merged into a ready-to-use utility. Unless you want to 
change the help text, HELP.SAV is the only file you need. 

A customization patch describes how to tailor the help text to your specific needs. 

2.4.2.7 Printer Handlers 

The software kit includes the printer handlers for a parallel interface, LPSYS 
(or LPX.SYS), and a serial interface, LS.SYS (or LSX.SYS). If your hardware 
configuration includes a serial interface printer instead of a parallel interface printer, 
you should include only LS.SYS or LSX.SYS in your working system. Further, if 
you are going to use the serial interface printer, you should include the following 
command line in your start-up command file: 

ASSIGN LS LP 

If your serial interface printer is installed at nonstandard vector and control status 
register (CSR) addresses, use the SET command to change the addresses. See the 
RT-11 Commands Manual for all LS handler SET commands. 

2.4.2.8 MACRO-11 Assembler 

To use the MACRO-11 assembler, you need the files MACRO.SAV and SYSMAC.SML 
(the system macro library) on the system volume. See the Introduction to RT-11 
and the RT-11 System Utilities Manual for descriptions of the assembly process. 
If you are going to be assembling any system components, you should also have 
SYSTEM.MLB on your system device, as SYSTEM.MLB is a library of system data 
structures with the supported data structure names and elements. You should also 
have SYSTEM.MLB on your system device if you are going to call for any system 
data structures in your own programs. You will then be using the same label names 
as used by RT-11. 
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2.4.2.9 Printer Utilities 

RT-11 contains two utilities, QUEUE and SPOOL, that are used to send output to 
the printer. Both utihties can be used as foreground or system jobs. 

QUEUE is perhaps more appropriate for use on a small system as it does not use 
a permanent intermediate file, but rather a small temporary work file. SPOOL is 
very useful on larger systems, as output can be directed in multiple streams. See 
the RT-11 System Utilities Manual for a description of QUEUE and SPOOL. 

2.4.2.10 Source Files 

Normally, you do not need any source files in your working system except 
demonstration sources. Otherwise, the source files (file type .MAC) are required 
only for the system generation process. 

You need the DEMOBG.MAC and DEMOFG.MAC demonstration sources in the 
working system to perform the exercises in Chapters 3 through 9 of this manual 
and in the Introduction to RT-11. Once you have finished those exercises, the 
demonstration source files are no longer useful and can be deleted from your working 
disk. 

2.4.2.11 Start-Up Command File 

Each RT-11 monitor looks for a matching start-up command file (STRTxx.COM) 
whenever you bootstrap the system. If it finds one, the monitor executes the 
commands in the file (to print a message, assign devices, and so on). If a monitor 
does not find a start-up command file, it prints a message indicating that the start- 
up file has not been found. See the Introduction to RT-11 for information on start-up 
command files. 

2.4.2.12 Text Editors 

RT-11 gives you a choice of two text editors. The Keypad Editor (KED or KEX) is 
an easy-to-use, cursor-oriented editor that you can use only on a VTlOO-compatible 
video terminal. KEX is the virtual version of KED; they function identically. KED 
is the default editor for unmapped monitors, and KEX is the default editor for the 
mapped monitors. The EDIT command automatically calls the correct version of the 
keypad editor for the monitor you are using, assuming the editor resides on your 
system device. 

The EDIT utility is a character-oriented text editor that you use with a hard-copy 
terminal. 

Refer to the Introduction to RT-11 for an introduction to the keypad editor and the 
PDP-11 Keypad Editor User's Guide for complete information. Refer to the RT-11 
Commands Manual for information on the EDIT utility. 

2.4.2.13 Utility Programs 

You do not need any system utility programs you do not intend to use, but remember 
that most of the keyboard monitor commands need certain system programs to 
work. For example, PIP, DUP, and DIR are necessary for most of the keyboard 
commands to function. Appendix A of the RT-11 Commands Manual summarizes 
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the keyboard monitor commands and lists the system utility programs that each 
command requires. 

Refer to the RT-11 System Utilities Manual for descriptions of the utility program 
functions. If your system device is a large disk, you will find it useful to have most 
of the utility programs on your working system device. On the other hand, if you 
have a small system device, you will not have room for all the utilities. 

You must include PIP, DUP, and DIR, and you probably want at least the correct 
version of the keypad editor and the HELP utility on your system volume. The 
utilities you use less frequently can occupy a second volume, as described in 
Section 2.5.2. 

2.5 Planning the Arrangement of Components for Smaller System 
Devices 

If your system volume is one of the smaller devices, the following is especially 
important. Consider the following suggestions before you build a working system; 
they can help you create an efficient system: 

• Assign the default device to the data device. 

• Create a separate utilities volume. 

• Create several system volumes. 

• Create volumes for use with Introduction to RT-11. 
More details on each of these suggestions follow. 

2.5.1 Assigning the Default Device to the Data Device 

Once you have installed the system, you can assign the default device DK to the 
nonsystem device unit. Most temporary files, data files, and others default to the 
second unit, minimizing demand for system device capacity. 

The command to assign the default device to a nonsystem device is as follows, where 
dev is the nonsystem device unit: 

.ASSIGN dev; DK: [Rfr] 

Include this command in your start-up command file to assign the default device to 
dev whenever you boot the system. The procedures in this manual assume DK has 
not been assigned and is also the system device unless indicated otherwise. (See the 
Introduction to RT-11.) 

2.5.2 Creating a Separate Utilities Volume 

Create a separate volume for the utility programs you expect to use infrequently. 
This technique provides you with a system volume containing all the components 
necessary to execute the majority of keyboard commands and perform common 
program preparation functions. When you need a seldom-used utility, you can insert 
the utilities volume in the nonsystem device unit and copy the utility temporarily 
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to the system volume. The utility can be run from the system volume by using 
appropriate DCL commands. 

NOTE 

The DIR, PIP, and DUP utilities should always reside 
on the system volume. 

If a utility contains no overlays, you can run the utility directly from the nonsystem 
device unit which reads the entire utility into memory. You can then reinsert the 
data volume in that device unit, keeping the utility in memory. An overlaid utility 
must be copied to the system volume before the data volume is reinserted. You can 
use the SIPP utility to determine if a utility (or any program) is overlaid. If SIPP 
asks for a segment number, the program is overlaid. For example, the following 
illustrates an overlaid pro^.SAV: 



.RUN SIPP 
*prog.SAV I RET 
Segment ? 

To run a non-overlaid utility from the utilities volume, use the following commands, 
where ddn is the physical device name, and aaaaaa is the utility program's name. 

.RUN ddn: aaaaaa |ret| 
* 

Then, issue the appropriate utility (not DCL) commands. When you are done with 
the utility, exit from the program: 



It is easier to simply copy a utility to the system device unit and run it from there. 
Not only do you not need to be concerned if a utility is overlaid, but you can use 
the simpler DCL command language (assuming the utility supports DCL commands, 
and most do). Try to keep some unused space on the system volume for temporarily 
storing and running seldom-used utilities. 

2.5.3 Creating Several System Volumes 

Create several system volumes, each devoted to a particular function. You can then 
change the system volume as normal job flow changes the functions you need. To 
change system volumes, wait for a logical stopping point in the job flow; do not 
arbitrarily remove the system volume in the middle of an operation. When you 
have reached a logical stopping point, exchange the system volumes and reboot the 
processor. The chapter in the Introduction to RT-11 that describes using VM as the 
system device contains examples of several system volumes. 

2.5.4 Creating Volumes for Use with Introduction to RT-11 

To perform the exercises in Introduction to RT-11, you need certain components on 
your working system. Because your system device is one of the small devices (RXOl, 
RX02, or RX50), you need to build one working system for all exercises other than 
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the programming part, and one working system for each programming chapter you 
intend to complete. 

2.5.4.1 Working System for Nonprogramming Part 

For all exercises other than the programming part, place at least the following files 
on your working system: 

SWAP.SYS 

RTllFB.SYS 

xx.SYS (system device handler) 

LP.SYS or LS.SYS (if appropriate) 

PIP.SAV 

DUP.SAV 

DIR.SAV 

BUPSAV 

KED.SAV 

SRCCOM.SAV 

RESORC.SAV 

DEMOFl.FOR 

DEM0F2.F0R 

2.5.4.2 Working System for Programming Part 

The following files are required to build any working system: 

SWAP.SYS 

RTllFB.SYS (or a different monitor) 

xx.SYS (system device handler) 

DIR.SAV 

DUPSAV 

PIPSAV 

The files required for each programming chapter are listed in the Choosing a 
Programming Language chapter. You will need the file, LIBR.SAV, to perform the 
exercises in Constructing Library Files. Additionally, you should place on the system 
volume the appropriate printer handler (if you have a printer) and an editor (KED 
or KEX). The demonstration programs are placed on the nonsystem (DK) device 
volume. 

2.6 Choosing Software Customizations 

In general, you use software customizations to modify an already supported feature. 
Also in general, you use the system generation procedure to add or remove support 
for a system feature. 

Examine Table 1-2 and read the following sections to determine what you need 
to do. Identify any non-system-generation customizations you need to make. You 
can perform the procedure for each selected customization during the installation 
process (Chapters 3 through 9). System generation is necessary only if you need a 
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customization that cannot be achieved with one of the procedures described in the 
following sections. 

NOTE 

Refer to Appendix D in the RT-11 System Generation 
Guide for additional modifications that further customize 
specially generated monitors. 

Use the SIPP utility to install software customizations. The RT-11 System Utilities 
Manual contains information on the SIPP utility; however, each customization patch 
contains the complete procedure. 

To customize your software: 

1. Determine which customization(s) you wish to make. 

2. Locate the symbol of the software component you wish to modify. The 
values of symbols for monitor customizations may be obtained from the link 
maps distributed with RT-11 as the files RTSB.MAP, RTFB.MAP, RTXB.MAP, 
RTXB.MAP, RTXM.MAP, RTZB.MAP, and RTZM.MAP The values of symbols for 
utility customizations are in the file CUSTOM.TXT. 

3. Follow the instructions to modify the software component, substituting the actual 
address value of the symbol in place of the symbol in the update. 

NOTE 

In the software customizations reproduced in this 
manual, question marks (?) represent unknown 
characters. These characters vary according to the 
specific software component. All numeric input values 
are octal unless otherwise indicated. 

2.6.1 Changing Characters That Indicate Insertion/Deletion 

You can modify SRCCOM to change the default characters that SRCCOM uses 
to indicate insertions and deletions on listings. Normally, when you use the 
DIFFERENCES/CHANGEBAR command or SRCCOM's /D option to compare two 
files, SRCCOM places vertical bars next to each line that has been added to the new 
file and bullets (lowercase alphabetic o) next to lines that have been deleted. You can 
modify SRCCOM to use characters other than the vertical bar and bullet characters, 

In the following customization, n is the ASCII code for the character you want to 
use to indicate insertions, and m is the ASCII code for the character you want to 
use to indicate deletions. 

.RUN SIPP [ret] 
*SRCCOM.SAV [rIi] 
Base? I RET I 

Offset? 1000 
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Base 


Offset 


Old 


New? 


000000 


001000 


?????? 


;A IRETI 


000000 


001000 


<o> 


; Aral RET 1 


000000 


001001 
001002 




;An |ret 


000000 


CTRL/Y 1 1 RET 1 


* 1 CTRL/C 1 









2.6.2 Changing Default Output Device from Printer to Terminal 

If your configuration does not have a printer, you can cause monitor commands to 
default to the terminal (TT) instead of the line printer (LP). Since several monitor 
commands default the output device to LP, you should edit the start-up command 
file to cause all system references to the device LP: to use the terminal. To change 
the defaults of such commands (for example, DUMP and PRINT), you need to add 
an ASSIGN TT: LP: command to the start-up file. Then, every time you bootstrap 
the system, the reassignment of the default device takes place. 

2.6.3 Changing the LD Handler Suffix Character 

Use the following customization patch to change the suffix character for the LD 
handler to anything other than X. (You can use the X suffix without performing a 
customization patch.) You must also use customization patch D.3, Changing the 
Handler File-Name Suffix, located in the RT-11 System Generation Guide. The 
following customization makes known to the monitor bootstrap the suffix character 
you specified in that customization; you must specify the same suffix character in 
both. 

In this customization, monitor. SYS is the name of the monitor file you want to 
modify, and ..BLDS is the value of that symbol from the monitor link map. The field 
y represents the suffix character you want to add to the LD handler name. 

.RUN SIPP [ret] 
*mon±t or. SYS |ret| 
Base? I RET I 

Offset ? . . BLDS [rIi] 



Base 


Offset Old 


New? 




000000 


. . BLDS 


?????? 


;Ay \j 


000000 


. . BLDS+2 


?????? 


1 CTRUY 1 


* 1 CTRL/C 1 









2.6.4 Changing the Number of Directory Columns 

You can modify DIR to change the number of columns in the directory listing 
that prints when you use the DIRECTORY command. Normally, the directory 
contains two sets of three columns, with each set listing file names and types, file 
size in blocks, and date of creation. If you use the /FAST or /BRIEF option with 
DIRECTORY, DIR lists only file names and types in five columns. You can also use 
the /COLUMNS:n option to specify the number of columns in the directory listing. 
However, if you want to change the default number of columns in the directory 
listing, install the following change. 
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In the customization, ffffff^^ ^in octal number (in the range 1 to 11) for the number of 
directory columns to be displayed when you use the DIRECTORY/FAST command. 
The value nnnnnn is an octal number (in the range 1 to 11) for the number of columns 
to be displayed when you use the DIRECTORY command. 



.RUN SIPP |RET 








*DIR.SAV |ret| 








Base? 


|ret| 






Offset? 1000 |RET| 






Base 


Offset 


Old 


New? 


000000 


001000 


?????? 


ffffff |RET| 


000000 


001002 
001004 


?????? 
?????? 


nnnnnn 1 ret | 


000000 


CTRL/Y 1 RET | 


* 1 CTRL/C 1 









2.6.5 Changing the Default Order of Directory Listings 

You can change the default order in which entries are listed in a directory listing. 
The current default order is by position in the directory. 

In the following customization, SWS is the value of that symbol from the 
CUSTOM.TXT file. The variable nnnnnn represents the address of SWS that SIPP 
returns in response to the search command. The variable yyyyyy represents the 
contents of nnnnnn+2. The variable zzzzzz requests the contents of SWS+2. The 
variable xxx represents one of the following default ordering options: 

DAT Order by date (earliest to latest) 

NAM Alphabetical order by file name 

POS Order by position in directory (current default) 

SIZ Order by size (smallest to largest) 

TYP Alphabetical order by file type 

.R SIPP [ret] 

*DIR.SAV [rHI 

Base? I RET I 

Offset? ;S [m] 

Search for? SWS I ret 

Start ? [r13 

End? I RET 

Found at nnnnnn 

Offset ? nnnnnn 



Base 


Offset 


Old 


New? 




000000 


nnnnnn 


SWS 


SWS+4 


|Ret| 


000000 


nnnnnn+2 


yyyyyy 


CTRL/Z 1 


|Ret| 


Offset ? SWS 


|ret| 








Base 


Offset 


Old 


New? 




000000 


SWS 


?????? 


;Rxxx 


|Ret| 


000000 


SWS+2 


zzzzzz 


CTRL/Y 


|Ret| 


* 1 CTRL/C 1 





2-20 RT-11 Installation Guide 



2.6.6 Changing the Number of /Q Program Sections LINK Allows 

You can alter LINK to change the number of absolute base address p-sects (/Q p-sects) 
that LINK allows. Normally, the /Q option to LINK lets you specify the absolute base 
addresses of up to eight p-sects in your program. You need absolute base address 
p-sects to prepare programs in absolute loading format for use in read-only memory 
(ROM) storage. Refer to the RT-11 System Utilities Manual for more information 
about absolute base address p-sects and about LINK in general. 

The limit of eight such p-sects, however, is the default number, and you can change 
it by altering LINK. LINK uses the number of p-sects to set up the /Q buffer area 
and to establish how many times it should ask the question: 

Load section: address? 

Note, however, that LINK allocates the buffer space even if you do not use the /Q 
option when you perform the link. LINK calculates the size of the buffer to be three 
times the contents of QSWNUM. 

To change the number of /Q p-sects LINK allows, use SIPP to change LINK.SAV as 
follows. QSWNUM is the value of that symbol from the CUSTOM.TXT file. The 
number nnn must be in the range 1 to ITTg; it represents the number of p-sects you 
want. 



.RUN SIPP 
*LINK.SAV [ret] 
Segment? |ret| 
Base? I RET I 

Offset? QSWNUM [rIi] 



Segment 


Base 


Offset 


Old 


New? 


000000 


000000 


QSWNUM 


?????? 


nnn \ ret | 


000000 


000000 


QSWNUM+2 


?????? 


1 CTRL/Y 1 


* |CTRL/C| 











2.6.7 Changing the Size of LINK'S Library Module List 

You can modify LINK to change the default size of LINK's list of library modules. 
LINK creates a list of 2528 modules to be included from libraries during the link 
operation. Because the size of each entry in this list is larger in RT-11 Version 5 
than in previous versions, the list may not be large enough for your application. You 
can use the LINK /P option at link time to increase the size of this list. If you want 
to change the default size of the list (and avoid using the /P option), you can modify 
the linker. You can still override the new default at link time by using /P. 

Note that if you increase the default size of the list, the maximum number of global 
symbols allowed in the link will be reduced. 

NOTE 

You must install this change if you use DIBOL. Make the 
default number of modules LINK holds 4008 or greater. 
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Segment 


Base 


Offset 


Old 


000000 


000000 


LMLSIZ 


?????? 


000000 


000000 


LMLSIZ+2 


?????? 



In the following customization, LMLSIZ is the value of that symbol from the 
CUSTOM.TXT file, and nnnnnn is the number of modules the list should hold. 

.RUN SIPP [ret] 
*LINK.SAV [ret] 
Segment? |ret| 
Base? I RET I 

Offset? LMLSIZ [ret] 

New? 
nnnnnn |ret| 

I CTRLA' I I RET I 
* I CTRL/C ] 

2.6.8 Changing the Size of the QUEUE \Nork File 

QUEUE, the device queue foreground program (or system job), uses a work file five 
blocks long. This work file allows you to queue approximately 127io files at once. If 
your application requires larger queues, you can modify QUEUE. REL to change the 
default size of the work file. 

In the following customization, QSIZE and QCBLK are the value of those symbols 
from the CUSTOM.TXT file, and nnn is the default size of the work file in octal 
blocks. To compute the approximate size of the work file that would be required for 
the number of files you need queued at once, use the formula: 

nnn = (max no. of file specs in queue at one time + l)/32 + 1 

.RUN SIPP [ret] 
*QUEUE.REL/A [^ 
Base? I RET I 

Offset? QSIZE [ret] 

New? 

nnn I ret 

CTRUZ I I RET I 



New? 

(nnn-1) |ret| 
(nnn- 1) *32 

CTRL/Y I RET I 



2.6.9 Modifying EDIT for Terminals with Nonstandard ESCAPE Codes 

You can modify the editor to allow it to operate correctly on terminals with 
nonstandard ESCAPE codes. Certain older terminals generate ITSg or ITGg, rather 
than the standard SSg, when you type the ESCAPE or ALTMODE key. Because 
codes 175 and 176 represent legitimate characters on more modern terminals, EDIT 
does not recognize ESCAPE code as the command terminator in the older terminals. 

If you have an older terminal, you can correct the problem by making the following 
change, so that you can use the ESCAPE code as documented in the EDIT chapter of 
the RT-11 Commands Manual. In the change, ALTMDE is the value of that symbol 
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Base 


Offset 


Old 


000000 


QSIZE 


?????? 


000000 


QSIZE+2 


?????? 


Offset? QCBLK |RET| 




Base 


Offset 


Old 


000000 


QCBLK 


?????? 


000000 


QCBLK+2 


?????? 


000000 


QCBLK+4 


?????? 


* 1 CTRL/C 1 





Base 


Offset 


Old 


000000 


ALTMDE 


?????? 


Base 


Offset 


Old 


000000 


ALTMDE 


??? 


000000 


ALTMDE+1 


??? 


1 CTRL/C 1 





from the CUSTOM.TXT file, and nnn represents the octal code that your terminal 
generates when you type the ESCAPE key on it. 

.RUN SIPP [ret] 
*EDIT.SAV [r13 
Base? I RET I 

Offset? ALTMDE [ret] 

New? 

New? 

nnn |ret 
ctrl/y I ret I 



The character $ echoes on the terminal, regardless of the octal value used for the 
ESCAPE code. However, EDIT recognizes only the ESCAPE code you specify, not 
both. 

2.6.10 Installing Other Devices 

You may need to install device handlers that are available but are not installed in 
the standard monitors. Installing a device handler adds information to the monitor 
device tables, so that you can use the device. Many devices are available in the 
standard monitors. (Refer to the RT-11 Commands Manual for a list of available 
devices.) You can perform the system generation process to create monitors and 
handlers that support nonstandard devices. The RT-11 Device Handlers Manual 
describes how to write your own device handler. 

When you bootstrap RT-11: 

• The bootstrap routine locates the system device handler and installs it. 

• Then the bootstrap looks at the rest of the device handler files on the system 
device and tries to install the device handler for each device it finds in the 
configuration. It does not try to install any handlers for which there is no 
hardware. 

• If there are more handlers than device slots, the bootstrap uses a certain priority 
scheme to establish which handlers to install. 

Refer to the RT-11 System Internals Manual for a description of these priorities. 

The SHOW command lists all installed device handlers and specifies when any empty 
device slots are available. 
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.SHOW [rIt] 

DU (Resident) 

DUO = SY , DK 
LD 
DX 
SL 
UB 
LS 
NL 
14 free slots 

If the bootstrap did not install a device when you booted the system, it did not have 
enough device slots when it encountered the handler, the hardware was not present, 
or the device handler was not present. To install a device, ensure that the correct 
handler is on the system device and that the hardware is present. If there are no free 
slots, use the REMOVE command to remove an unneeded device and the INSTALL 
command to install the device you need. 

.REMOVE LS: 
.INSTALL LP: 

The standard (distributed) monitors provide a total of I610 device slots. If your 
application requires more than 16 device slots simultaneously, you must perform a 
system generation to create your own monitor and device handlers. 

To control which handlers the bootstrap installs, place on the system device for your 
working system only the handlers for the devices you will be using. Do not include 
the handler for a device you will not be using. 

You can keep a handler from being installed at boot time by giving it a name that 
does not correspond to the naming conventions for the monitor being booted. A 
device handler is named yy.SYS for unmapped monitors and yyX.SYS for mapped 
monitors (where yy is the device name). Use the RENAME command to rename a 
handler. 

The bootstrap cannot install support for some devices. Thus, different procedures 
are required. The following sections describe how you can change the control status 
register (CSR) and vector addresses for the parallel and serial interface printers, 
RXOl and RX02 diskettes, and MSCP disks, and how you can install hardware 
magtape support, and set magtape parity and density. 

2.6.10.1 CSR and Vector Addresses for Printers, RX01/02 Diskettes and IViSCP Disks 

With the SET command, you can change the CSR and vector addresses of five 
devices: parallel and serial interface printers, RXOl and RX02 diskettes, and MSCP 
disks. You need to change the addresses if the controller is installed at nonstandard 
addresses. When using the SET command, enter the following commands, where dd 
is the device mnemonic (LP, LS, DX, DY, or DU), aaaaaa is the CSR address, and 
bbb is the vector address. 

.SET dd: CSR2=aaaaaa I ret 
.SET dd: VEC2=bbb [ret] 

.SET dd: CSR=aaaaaa |ret| 
.SET dd: VECTOR=bbb [ret] 
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In addition, the following commands are valid for MSCP disks: 

.SET DU: CSR3=aaaaaa I ret 
.SET DU: VEC3=bbb [ret] 

.SET DU: CSR4=aaaaaa |ret 
.SET DU: VEC4=bbb [rHI 

Use the following command to assign RT-11 unit numbers to MSCP disks, where n 
is the RT-11 unit number and x is the MSCP unit number: 

.SET DUn: UNIT=x [Rfr] 

To partition MSCP disks, use the following command, where n is the RT-11 unit 
number and x is the partition number: 

. SET DUn : PART=x |ret| 

You can also assign unit numbers to the MSCP ports. To generate support for the 
following command, you must perform a system generation and respond to question 
108 (How many ports are to be supported (1) ?) with 2, 3, or 4. The distributed 
monitors do not support this command. In the command, n is the RT-11 unit number 
and X is the port number: 

. SET DUn : PORT=x |ret| 

See the description of the SET command in the RT-11 Commands Manual and the 
RT-11 Device Handlers Manual for more information on partitioning MSCP disks 
and assigning ports. 

These commands permanently alter the handler .SYS file. That is, the CSR and 
vector addresses you specify remain in effect even if the system is rebooted. If you 
want to change the addresses again, you can use the SET command again. 

2.6.10.2 Hardware Magtape Support 

You can choose to install hardware magtape support, rather than use file-structured 
magtape support. File-structured handlers include hardware magtape handler 
features; however, hardware magtape handlers are smaller. 

File-structured magtape handlers are distributed as part of the RT-11 operating 
system; hardware magtape handlers are not. If you want to use hardware magtape 
handlers, you must perform a system generation. System generation produces either 
file-structured or hardware magtape handlers, but not both at the same time. 

The files MT.SYS, MTX.SYS, MM.SYS, MMX.SYS, MS.SYS, MSX.SYS, MU.SYS, 
and MUX.SYS are distributed file-structured handlers for TMll, TJU16, TSll, 
and TMSCP magtape devices. The files MTHD.SYS, MTHDX.SYS, MMHD.SYS, 
MMHDX.SYS, MSHD.SYS, MSHDX.SYS, MUHD.SYS, and MUHDX.SYS are the 
system-generated hardware magtape handlers for the same devices. There are two 
sets of handlers: one for unmapped monitors, the other for mapped monitors. The 
file-name suffix X indicates device support for mapped monitors. 
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The two ways to install a hardware magtape handler in place of the file-structured 
handler are: 

1. Rename the distributed file-structured handler to save it, rename the 
corresponding hardware magtape handler to the original name of the file- 
structured handler, and reboot the system to let the bootstrap install the handler. 

2. Use the INSTALL and REMOVE commands: 

• Make sure the hardware magtape handler for your monitor and device is on 
the system disk. 

• Rename the distributed file-structured handler to save it. 

• Remove the file-structured handler from the system volume. 

• Rename the corresponding hardware magtape handler to the name of the 
distributed file-structured handler. 

• Install the renamed hardware magtape handler. 

For example, to install TSll hardware support in place of TSll file-structured 
support, first make sure that the correct (unmapped or mapped) version of the 
hardware magtape handler (MSHD.SYS or MSHDX.SYS) is on the system volume, 
and then do the following. In the example, the mapped version of the handler is 
used: 

1. Rename and remove the file-structured handler. (You must remove the old 
handler before you can install the new one.) 

.RENAME MS. SYS MS.FIL [ret] 
.REMOVE MS: [rIi] 

2. Rename and install the hardware magtape handler. 

.RENAME MSHD.SYS MS . SYS [ret] 
.INSTALL MS: 



The handler you have named MS. SYS will be installed in the device table when the 
system is bootstrapped. 

Table 2-3 identifies hardware handlers that you must rename, if you are using an 
unmapped monitor. Make sure you save the distributed (file-structured) handler. 

Table 2-3: File-Structured and Hardware Magtape Handlers for Unmapped 
Monitors 

TMll MT.SYS MTHD.SYS MT.SYS 

TJU16 MM.SYS MMHD.SYS MM.SYS 

TSll MS.SYS MSHD.SYS MS.SYS 

TMSCP MU.SYS MUHD.SYS MU.SYS 
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Table 2-4 identifies hardware handlers that you must rename, if you are using a 
mapped monitor. Make sure you save the distributed (file-structured) handler. 

Table 2-4: File-Structured and Hardware Magtape Handlers for Mapped Monitors 



TMll MTX.SYS 

TJU16 MMX.SYS 

TSll MSX.SYS 

TMSCP MUX.SYS 



MTHDX.SYS MTX.SYS 

MMHDX.SYS MMX.SYS 

MSHDX.SYS MSX.SYS 

MUHDX.SYS MUX.SYS 



2.6.10.3 Magtape Parity and Density 

To operate TMll or TJU16 magtape at parity or density settings different from 
standard support, you can use the monitor SET command as described in the RT-11 
Commands Manual. The distributed monitors support seven- and nine-track TMll 
and TJU16 magtape at 800 bits/in and odd parity. You cannot set the density of 
TSll magtape, since it is 1600 bits/in odd parity only. 

2.6.11 Modifying BATCH to Save Space 

BATCH support requires system generation. Once you have generated BATCH 
support, to minimize space demands on your system device, you can modify BATCH 
to access certain system programs on DK rather than on SY. These customizations 
allow you to store certain system programs on DK rather than on SY and let BATCH 
access them there. 

You can make any or all of the customizations. Modify BATCH for the system 
programs you need to remove from the system device. Copy the programs for which 
you install changes to the device on which you want them to reside; then, delete 
them from the system device (SY). Finally, use the ASSIGN command to assign the 
logical name DK to the device to which you copied the system programs. Then, run 
BATCH as usual. 

The following change to BATCH makes DK the default storage volume for one of 
the specified programs. In the patch, nnnnnn is the octal value for the symbol that 
corresponds to the program you want to affect. The values for the symbols can be 
found in the file CUSTOM.TXT on your distribution kit. 



Program 



Symbol 



DIR 


..RDIR 


MACRO 


..RMAC 


FORTRAN 


..RFOR 


LINK 


..RLIN 


PIP 


..RPIP 


BASIC 


..RBAS 
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.RUN SIPP 


|ret 






*BATCH. SAV 


|ret| 






Base? 





RET 






Offset ? 


nnnnnn ret 






Base 




Offset 


Old 


New? 


BASE 




nnnnnn 


?????? 


\|ret| 


Base 




Offset 


Old 


New? 


BASE 




nnnnnn 


??? 


125 


BASE 




nnnnnn+1 


??? 


1 CTRL/Y 1 


* 1 CTRUC 1 











[ml 



Once you assign DK to a device other than SY, the new device becomes the default 
input and output storage device for most system programs. You may need to modify 
BATCH jobs to reference certain files on SY explicitly, since that is no longer the 
same device as DK. You can keep .BAT and .CTL files on SY by invoking BATCH as 
follows: 

.RUN BATCH [ret] 
*SY:myjob=SY:myjob |ret| 

2.6.12 Modifying LINK to Change tlie Default SYSLIB Device 

You can modify the linker to make it look for the default system library 
(SYSLIB. OBJ) on the device you choose instead of on the system device (SY). This 
change may be useful if you have space problems on your system device, because 
you can then place SYSLIB on the device you have specified to LINK. 

To change the device on which SYSLIB. OBJ resides, make the following change to 
LINK. SAV. In the customization, dev is the name of the device on which you want 
to place SYSLIB. 

.RUN SIPP [ret] 
*LINK.SAV [ret] 
Segment? |ret| 
Base? I RET I 

Offset? SYSLIB [rIi] 



Segment 


Base 


Offset 


Old 


New? 


000000 


000000 


SYSLIB 


■p 


;Rdev |ret| 


000000 


000000 


SYSLIB+2 


■p 


1 CTRL/Y 1 1 RET | 


* 1 CTRL/C 1 











2.6.13 Modifying the Help Text 

To change the help text that prints when you use the HELP command, you must 
create your own help text file, process that file with LIBR, and copy the resulting 
library and the file HELP.EXE to the same volume. 

The files HELP.TXT and HELP.EXE, which together make up the program 
HELPSAV, are not provided on the distribution kit. Therefore, to change your HELP 
text, you must first recreate HELP.TXT and HELP.EXE from HELPSAV using the 
unsupported utility SPLIT. 
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To recreate these files, type this command: 

. SPLIT ddn : HELP . EXE, , ddn : HELP . TXT=ddn : HELP . SAV/B : . . HLPl : . . HLP2 [ret] 

In the command, ddn: represents the device on which to create the files HELP.TXT 
and HELP.EXE, or the device on which HELP.SAV exists. The variables ..HLPl and 
..HLP2 represent the boundaries along which to split HELP.SAV. Refer to the file 
CUSTOM.TXT on your distribution kit for the values to substitute in the command 
line for ..HLPl and ..HLP2. 

HELP.SAV is the only file you need if you do not want to change the help text. 
However, if you do want to change the text that prints when you use the HELP 
command, you must perform the following procedure. 

First, edit the file HELP.TXT in your working system. Make sure that this file (as 
well as the rest of the distribution) is safely backed up and the actual distribution 
media are stored away. Add any explanations your application requires and delete 
any explanations that do not apply to your application. 

When you edit HELP.TXT, you must use a specific format, as follows: 

1. Give each topic in the file an alphabetic name. 

2. The name you give must be unique within the first six characters. 

3. Place each topic on a page, delimited by form feeds. (See the following example.) 

4. Place topics in alphabetical order in the file. 

5. Leave the dummy topic 999999 at the end of the file. 

The following illustrates the format of a topic, properly formatted, on a page. 

. MACRO [tobI TOPICNAME [ret] [lfI 

TOPICNAME froil ONE LINE DESCRIPTION OF THE TOPIC [ret] [lfI 

[sp] [sp] SUBTOPICNAME [ret] [lfI 

[rail TEXT ABOUT THE SUBTOPIC [ret] [lfI 

[railMORE TEXT (ANY NUMBER OF LINES) [ret] [Ul 

[sp] [sp] [sp] SUBTOPICITEMNAME [ret] [lfI 

It^DESCRIPTION of SUBTOPIC ITEM [USUALLY ONLY FOR [ret] [lfI 

Ij^THE SUBTOPIC 'OPTION'], ANY NUMBER OF LINES [ret] [Ul 

[ANOTHER SUBTOPIC, STARTING FROM THE BLANK LINE ABOVE] 

.ENDM [ret1[lf1 

Now, create the help text library file by processing HELP.TXT with the librarian. 
Use the following command: 

. LIBR/MACRO HELP . MLB HELP . TXT [Rfr] 

You can leave HELPMLB as a separate file or merge it with HELP.EXE. 

To run HELP with a separate program and text library file or files, copy HELP.EXE 
to the system volume. When you copy HELP.EXE, name it HELP.SAV. 
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.COPY/CONCATENATE HELP . EXE , HELP . MLB HELP . SAV [ret] 

Make sure that the file HELP.MLB that you create is also on the system volume. 
You can back up HE LP. EXE and HE LP. TXT on another volume and delete them 
from the system volume. Then, to invoke HELP, type: 

.HELP [rIi] 

If you leave HELP.MLB separate, you can alter it more easily in the future. However, 
if HELP.MLB is a separate file, the program runs more slowly. This problem is 
significant on systems that use a small device (for example, diskette) as the system 
device. 

Digital recommends that you merge the two files, since the program runs faster that 
way. Use the following command to merge the program and text library file or files. 

.COPY/CONCATENATE HELP . EXE , HELP . MLB HELP . SAV [Rfr] 

In this case too, you can back up HELPEXE and HELPTXT on another volume and 
delete them from the system volume. You can also delete the file HELP.MLB, since 
you can recreate it from the file HELPTXT. 

2.6.14 Preventing Fatal System Errors from Causing a Reset 

Normally, the monitor performs a hard reset when a fatal system error occurs. The 
reset stops I/O transfers, minimizing the possibility that the error will corrupt media. 
In some cases, the cause of software errors might still be in memory, and the reset 
preserves the data, making it possible to analyze the error. 

However, in rare cases, the reset may prevent diagnosis of hardware errors. If 
you prefer to suppress the reset, you can install the following change in the monitor, 
although doing so increases the risk of corrupting media. Digital does not recommend 
using a monitor with this customization installed except for diagnostic purposes. Do 
not use such a monitor for normal operations. 

In the customization, monitr.SYS is the name of the monitor file you want to modify, 
and FATAL is the value of that symbol from the monitor link map. 



.RUN SIPP |ret 






*monitr.SYS |ret| 






Base? |ret| 






Offset? FATAL |RET| 






Base Offset 


Old 


New? 


000000 FATAL 


?????? 


240 |ret 


000000 FATAL+2 


?????? 


CTRL/Y 1 RET | 


* 1 CTRL/C 1 
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2.6.15 Running RT-11 in Less Memory Than Is Available 

If your application requires that RT-11 run in less memory than is available, you can 
make a customization that allows you to bootstrap the system to run in the lower 
12K words or 8K words of a 16K word machine. The SB and FB monitors have 
bootstraps that allow the system to run in less memory than is available. (This 
cannot be done for mapped monitors, because the mapped monitors require 32K 
memory.) The distributed monitors automatically make use of all available memory, 
since most applications require that RT-11 do so. However, if your configuration 
includes a hardware switch register and your application requires less memory, you 
can make the following customization. In the customization, monitr.SYS is the name 
of the unmapped monitor file that you want to modify, and BHALT is the value of 
that symbol from the monitor link map. 

.RUN SIPP [ret] 
*monitr.SYS |ret| 
Base? I RET I 

Offset? BHALT [rIi] 



Base 
000000 
000000 


Offset 
BHALT 
BHALT+2 


Old 
?????? 
?????? 


New? 

1 RET 1 
CTRL/Y 1 1 RET 1 


1 CTRL/C 1 





If this is the hardware bootable monitor, you must write a new system bootstrap 
with the COPY/BOOT command after you install this change. 

Once you make the change to your monitor, a halt occurs whenever you boot that 
monitor file. While the system is halted, set the switch register to one of the values 
from the following table and press the CONTINUE switch; the bootstrap operation 
then completes for the memory size you specify. 



Value 



Size in Words 



40000 


8K 


44000 


9K 


50000 


lOK 


54000 


UK 


60000 


12K 


64000 


13K 


70000 


14K 


74000 


15K 


100000 


16K 


104000 


17K 


110000 


18K 


114000 


19K 


120000 


20K 


124000 


2 IK 
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Value Size in Words 



130000 


22K 


134000 


23K 


140000 


24K 


144000 


25K 


150000 


26K 


154000 


27K 



If your configuration does not include a hardware switch register or if you always 
want the system to boot in a specified amount of memory without halting, you can 
make the following customization. In the customization, monitr.SYS is the name of 
the monitor file that you want to modify, and nnnnnn is a value from the preceding 
table. 



.RUN SIPP [ret] 
*mon±tr . SYS |ret| 
Base? I RET I 

Offset ? BHALT 



Base 


Offset 


Old 


New? 


000000 


BHALT 


?????? 


240 |RET 


000000 


BHALT 


?????? 


12704 IRET 


000000 


BHALT 
BHALT 


?????? 
?????? 


nnnnnn 1 ret | 


000000 


1 CTRLVY 1 1 RET 1 


1 CTRL/C 1 





If this is the hardware bootable monitor, write a new system bootstrap with the 
COPY/BOOT command. Once you change your monitor, the system will boot in the 
memory you specify whenever you boot the customized monitor file. 

To run RT-11 in exactly 28K words, use the customization in Section 2.6.20. 

2.6.16 Setting VTCOM Default Dial String 

Apply one of the following customizations to VTCOM.REL or VTCOM.SAV to set a 
default dial string for the DIAL command. 

In the customization, the symbol ..DIAL represents the address of the first character 
in the dial string. You can find the correct value for the symbol ..DIAL in the file 
CUSTOM.TXT on your distribution kit. Replace the symbols a, b, and so on, with 
the ASCII characters that make up your dial string. Add a mandatory null byte 
(a zero) following the last character of your dial string. The dial string cannot be 
longer than 39 characters. The fortieth byte must be a null. 

To modify VTCOM.REL: 

.R SIPP [ret] 
*VTCOM.REL [rIi] 
Base? I RET I 

Offset ? . . DIAL 
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Base 


Offset 


Old 


New? 


000000 


. .DIAL 


?????? 


;Aa |RET 


000000 


. .DIAL+1 


??? 


;Ab |ret 


000000 


. .DIAL+2 


??? 


;Ac |ret 


000000 


. .DIAL+47 


??? 


IretI 


000000 


. .DIAL+50 


??? 


1 CTRUY 1 1 RET 1 



* |CTRL/C| 






To modify VTCOM.SAV: 






.R SIPP |RET| 






*VTCOM.SAV |RET| 






Seament? 1 |ret| 






Base? |ret| 






Offset? . .DIAL |ret| 






Segment Base Offset 


Old 


000001 000000 


.DIAL 


?????? 


000001 000000 


. DIAL+1 


??? 


000001 000000 


. DIAL+4 7 


??? 


000001 000000 


. DIAL+50 


??? 


* 1 CTRL/C 1 







New? 

Aa I RET I 
Ab [rIi] 



\m} 



\m} 



2.6.17 Setting Upper Limit on a File Size 

If your application requires an upper limit on the size of a file, you can install a 
customization that changes the maximum size RT-11 allocates in a general .ENTER 
request. On distributed monitors, the .ENTER programmed request allocates space 
in such a way that the maximum size of a file is either half the largest space 
available or the entire second largest space available, whichever is larger. For most 
applications, this scheme is satisfactory and should be left unchanged. However, if 
yours is an application that requires an upper limit, you should make the following 
change. 

In the customization, monitr.SYS is the name of the monitor file that you want to 
modify, $RMON is the value of that symbol from the monitor link map, and nnnnnn 
is the octal number of blocks that is to be the maximum file size for a general 
.ENTER. 

.RUN SIPP [ret] 
*monitr.SYS |ret| 
Base? $RMON [ret] 

Offset? 314 [rIi] 



Base 
$RMON 


Offset 
000314 
000316 


Old 
?????? 
?????? 


New? 
nnnnnn \ ret | 


$RMON 


CTRL7Y 1 1 RET 1 


1 CTRUC 1 
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2.6.18 Changing the Number of Bad Blocks That BUP Accepts 

By default, BUP successfully handles up to 25 bad blocks on the input device when 
backing up a disk to a tape or when restoring from a tape to a disk (copy back). 
If any bad blocks are encountered on the output device, BUP issues a fatal error 
message and stops the backup operation. 

BUP issues a warning message each time it encounters a bad block on the input 
device, then continues to back up or restore. If BUP encounters more than 25 bad 
blocks on the input device, BUP issues a fatal error message and the operation is 
stopped. 

Use the following customization to set your own value for the number of bad blocks 
on the input device that BUP will accept. 

In the customization, ..MBAD is the symbol for the value found in the file 
CUSTOM.TXT, and nnnnn is the new value that you enter. The maximum value 
you can enter is 11111^; that is, you can customize BUP to read 11111^ bad blocks 
on the input device before the next bad block encountered causes a fatal error. The 
value you enter is also the number of verification mismatches that BUP reads on 
the input device before the subsequent mismatch causes a fatal error. 



.RUN SIPP |ret 








*BUP.SAV |ret| 








Segment? |ret| 








Base? |ret| 








Offset? ..MBAD |ret| 








Base Offset 


Old 


New? 




000000 . .MBAD 


?? 


nnnnn 


RET 


000000 . .MBAD+2 


???? 


CTRL7Y 


RET 


* 1 CTRL/C 1 









2.6.19 Changing the Default File Type Extension of IND Control Files 

As distributed, the file type extension for IND control files is .COM. You can change 
that extension to distinguish IND control files from KMON command files (which 
also use the extension .COM). 

In the customization, ..INDF is the symbol for a value located in the file 
CUSTOM.TXT, and nnn is the new default RAD50 3-character file type extension. 



.RUN SIPP 
* IND. SAV 
Segment ? 
Base? 
Offset ? 


|ret 
|ret| 
|Ret| 
|ret| 
. . INDF 1 ret 1 






Segment 

000000 

000000 

* 1 CTRL/C 1 


Base Offset 
000000 . . INDF 
000000 . . INDF 


Old 
?????? 
?????? 


New? 

; R 1 ret 1 

; Rnnn \ ctrl/y | 
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2.6.20 Setting Upper Limit on Memory Size 

If your PDP-11 does not generate a bus timeout trap when the running program 
accesses location 160000, the RT-11 bootstrap may assume that you have an LSI-11 
with the MSVll-DD memory option. The bootstrap assumes that there are 30K 
words available for the operating system. If this is not the case, RT-11 will not load 
into memory properly. However, if you install the following customization in your 
monitor, the bootstrap will never look for more than 28K words of memory. You 
cannot install this customization in a mapped monitor. 

In the customization, monitr.SYS is the name of the monitor file you want to modify 
(SB or FB), and ..28KW is the symbol for the value found in the monitor link map 
on your software distribution kit. 



.RUN SIPP |RET 
*monitr . SYS /A \ ret | 
Base ? 1 RET 1 
Offset? . .28KW |ret| 

Base Offset 
000000 . .28KW 
000000 . . 28KW+2 


Old 
?????? 
?????? 


* 1 CTRL/C 1 





New? 

16000 [rIt] 
ctrl/y i ret i 



If the monitor you modify is the hardware bootable monitor, write a new system 
bootstrap with the COPY/BOOT command. 

2.6.21 Suppressing tlie Bootstrap Message 

You can modify a monitor to prevent the monitor identification message from printing 
when you bootstrap that monitor. In the customization, monitr.SYS is the name of 
the monitor file that you want to modify, and ..SLNT is the value of that symbol 
from the monitor link map. 



.RUN SIPP |RET 






*monitr.SYS |ret| 






Base? |ret| 






Offset ? . . SLNT 1 RET 1 






Base Offset 


Old 


New? 


000000 . . SLNT 


?????? 


1 1 RET 1 


000000 . . SLNT+2 


?????? 


CTRL7Y 1 1 RET 1 


* 1 CTRUC 1 





If the monitor you modify is the hardware bootable monitor, write a new system 
bootstrap with the COPY/BOOT command. 

2.6.22 Suppressing the Start-Up Indirect Command File 

You can suppress the monitor from calling a start-up command file when you 
bootstrap that monitor. The standard monitors include start-up command file 
support although you need not select it if you perform the system generation process 
to create special monitors. In the customization, monitr.SYS is the name of the 
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monitor file that you want to modify, and ..NIND is the value of that symbol from 
the monitor link map. 



.RUN SIPP |RET 






*monitr.SYS |ret| 






Base? |ret| 






Offset? . .NIND |RET| 






Base Offset 


Old 


New? 


000000 . . NIND 


?????? 


1 RET 1 


000000 . .NIND+2 


?????? 


CTRL/Y 1 RET | 


* 1 CTRL/C 1 





If the monitor you modify is the hardware bootable monitor, write a new system 
bootstrap with the COPY/BOOT command. 

2.6.23 Suppressing the Start-Up Indirect Command File Echo 

You can modify a monitor to execute the start-up indirect command file when you 
bootstrap a monitor but not echo (display) the command lines in the file. This 
customization causes the monitor to use the SET TT QUIET mode of operation. 
In the customization, monitr.SYS is the name of the monitor file that you want to 
modify, and ..TTQU is the value of that symbol from the monitor link map. 



.RUN SIPP |RET 






*monitr.SYS |ret| 






Base? |ret| 






Offset? . .TTOU |RET| 






Base Offset 


Old 


New? 


000000 . . TTQU 


?????? 


1 1 RET 1 


000000 . . TTQU+2 


?????? 


CTRL/Y 1 RET | 


* 1 CTRL/C 1 





If the monitor you modify is the hardware bootable monitor, write a new system 
bootstrap with the COPY/BOOT command. 

2.6.24 Changing the Bootstrap Message 

You can modify a monitor to change the monitor identification message that appears 
when you bootstrap that monitor. Place the string (the message) in the monitor 
image starting at location BSTRNG. End the string with a null byte. The string 
must not be more than 20io bytes long, including the null byte. If the monitor you 
modify is the hardware bootable monitor, write a new system bootstrap with the 
COPY/BOOT command. 

2.6.25 Changing the Default Device for Indirect Command Files 

You can change the default device for indirect command files. Normally, when you 
invoke an indirect command file (by typing $@filnam), the default device where the 
monitor looks for the command file is DK. If you have a special application, you can 
change this default to any three-character device name. 
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Base 


Offset 


Old 


000000 


. .ATDK 


?????? 


000000 


. .ATDK 


<DK > 


000000 


. .ATDK+2 


????? 


1 CTRL/C 1 





In the customization, monitr.SYS is the name of the monitor file that you want to 
modify, ..ATDK is the value of that symbol from the monitor link map, and nnn is 
the new default device name. 

.RUN SIPP [ret] 
*mon±tr.SYS |ret| 
Base? I RET I 

Offset ? . . ATDK [ret] 

New? 

;R [ret] 
; Rnnn |ret| 
CTRL/Y I ret I 



2.6.26 Changing the Default File Type for Indirect Command Files 

You can change the default file type for indirect command files. Normally, indirect 
command files have the default file type .COM. When you invoke an indirect 
command file (by typing $@filnam), the monitor looks for the file filnam.COM. If 
you have a special application, you can change this default to any three-character 
file type. 

In the customization, monitr.SYS is the name of the monitor file that you want to 
modify, ..ATFX is the value of that symbol from the monitor link map, and nnn is 
the new default file type. 

.RUN SIPP [ret] 
*mon±tr.SYS |ret| 
Base? I RET I 

Offset ? . . ATFX [ret] 

New? 

;R [ret] 
; Rnnn |ret| 

CTRL7Y I RET I 



2.6.27 Changing the Default Device for the FRUN Command 

You can change the default device for the FRUN command. Normally, when you 
start a foreground program (by typing FRUN filnam), the default device where the 
monitor looks for the program file is DK:. If you have a special application, you can 
change this default device to any three-character device name. 

In the customization, monitr.SYS is the name of the monitor file that you want to 
modify, ..FRDK is the value of that symbol from the monitor link map, and nnn is 
the new default device name. 

.RUN SIPP [ret] 
*monitr.SYS |ret| 
Base? I RET I 

Offset ? . . FRDK [rHI 



Base 


Offset 


Old 


000000 


. .ATFX 


?????? 


000000 


. .ATFX 


<COM> 


000000 


. .ATFX+2 


<???> 


1 CTRL/C 1 
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Base 


Offset 


Old 


000000 


. .FRDK 


?????? 


000000 


. .FRDK 


<DK > 


000000 


. .FRDK+2 


<???> 


1 CTRL/C 1 





Base 


Offset 


Old 


000000 


. .FRUX 


?????? 


000000 


. .FRUX 


<REL> 


000000 


. .FRUX+2 


????? 


1 CTRL/C 1 





New? 

;R [ret] 
; Rnnn |ret| 

CTRL/Y I RET I 



2.6.28 Changing the Default File Type for the FRUN Command 

You can change the default file type for foreground programs from .REL (the default) 
to any three-character file type. 

In the customization, monitr.SYS is the name of the monitor file that you want to 
modify, ..FRUX is the value of that symbol from the monitor link map, and nnn is 
the new default file type. 

.RUN SIPP [ret] 
*monitr . SYS |ret| 
Base? I RET I 

Offset ? . . FRUX [ret] 

New? 

R [ret] 

; Rnnn |ret| 

CTRL/Y I RET I 



2.6.29 Changing the Default Device for the EDIT Utility Command 

The customization changes the default device for the EDIT hard-copy editor only; 
it does not change the default device for the KED or KEX keypad editors. Further, 
as EDITSAV is not the default editor under any monitor, you must include 
the command SET EDIT EDIT in your start-up command file or perform the 
customization patch in Section 2.6.30 before this patch has effect. 

Assuming you have made EDIT the default editor, if you then want to change the 
default device for the EDIT command, you can modify the monitor. Normally, when 
you invoke an editor by typing the EDIT command, the default device where the 
monitor looks for EDIT.SAV is SY. If you have a special application, you can change 
this default device to any three-character device name. 

In the customization, monitr.SYS is the name of the monitor file that you want to 
modify, ..EDDV is the value of that symbol from the monitor link map, and nnn is 
the new default device name. 

.RUN SIPP [ret] 
*mon±tr.SYS |ret| 
Base? I RET I 

Offset ? . . EDDV [ret] 

New? 

;R [ret] 
; Rnnn |ret| 

CTRL/Y I RET I 



Base 


Offset 


Old 


000000 


. .EDDV 


?????? 


000000 


. . EDDV 


<SY > 


000000 


. .EDDV+2 


????? 


1 CTRL/C 1 
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2.6.30 Changing the Default File Name for the EDIT Command 

You can change the default editor that is run when you type the EDIT command. 

In the customization, monitr.SYS is the name of the monitor file that you want to 
modify, PROGDF is the value of that symbol from the monitor link map, and EEE is 
2008 plus the new byte value of one of the following symbols from the monitor link 
map: 

$$EDIT Command value for default editor EDIT 

$$KED Command value for default editor KED 

$$KEX Command value for default editor KEX 

.RUN SIPP [ret] 
*mon±tr . SYS |ret| 
Base? I RET I 

Offset? PROGDF 



Base 


Offset 


Old 


New? 


000000 


PROGDF 


?????? 


\ 1 RET 1 


Base 


Offset 


Old 


New? 


000000 


PROGDF 
PROGDF+1 


??? 
??? 


EEE 1 RET 


000000 


CTRL7Y 1 RET | 


1 CTRL/C 1 





2.6.31 Using Examine and Deposit Above the Background Job 

If you want to be able to examine and modify the monitor and the I/O page, you 
can modify the monitor to remove a restriction on the use of the E (Examine) and 
the D (Deposit) keyboard commands. Normally, the monitor allows you to examine 
and modify only locations inside the background job's area. You can remove this 
restriction, but you must be extremely careful when modifying the monitor or FO 
page, since you may inadvertently destroy the resident monitor or corrupt a device. 

In the customization, monitr.SYS is the name of the monitor file that you want to 
modify, and ..EMON is the value of that symbol from the monitor link map. 

.RUN SIPP [ret] 
*monitr.SYS |ret| 
Base? I RET I 

Offset ? . . EMON [rHI 



Base 


Offset 


Old 


New? 


000000 


. .EMON 


?????? 


240 |RET 


000000 


. . EMON+2 


?????? 


CTRL/Y 1 1 RET 1 


1 CTRL/C 1 





2.6.32 Changing the Default Device for QUEMAN 

You can change the default device for the queue manager (QUEMAN). Normally, 
when you use the PRINT or DELETE/ENTRY command (in an FB or XM system 
with QUEUE running as a foreground or system job), QUEMAN sends the file to 
the device LP or deletes the entry from the LP queue. If you frequently queue to 
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another device (such as the serial interface printer, LS), you can change the default 
device for these commands. 

In the customization, monitr.SYS is the name of the monitor file that you want to 
modify, ..QULP is the value of that symbol from the monitor link map, and dv is the 
two-character device name that you want as the default. 



.RUN SIPP Iret 




*monitr.SYS |ret| 




Base? |ret| 




Offset? . .QULP |ret| 




Base Offset 


Old 


000000 . . QULP 


?????? 


000000 . . QULP 


<L> 


000000 . . QULP+1 


<P> 


000000 . . QULP+2 


<:> 


* 1 CTRUC 1 





New? 

;A [Rfr] 
;Ad Iret 
;Av I RET 

CTRL7Y I RET I 



2.6.33 Changing the Indirect Command File Nesting Depth 

You can increase the indirect command file nesting depth. Normally, RT-11 allows 
you to nest indirect files to a depth of three. A nesting depth of three allows your 
indirect file to invoke another indirect file, which invokes still another indirect file. 
If you have a special application that requires more nesting, you can change the 
maximum nesting depth by modifying the monitor. Note that if you increase the 
nesting depth, any use of the indirect file feature will use more memory than is 
usual. 

In the customization, monitr.SYS is the name of the monitor file that you want to 
modify, $RMON is the value of that symbol from the monitor link map, and nnn 
is the maximum indirect file nesting depth that you want; nnn should be a small 
integer, and must not be zero. 

.RUN SIPP [ret] 
*mon±tr.SYS |ret| 
Base? $RMON [ret] 

Offset? 377 [rIi] 



Base 
$RMON 


Offset 
000377 
000400 


Old 
??? 
??? 


New? 

nnn \ ret 


$RMON 


CTRL/Y 1 RET | 


1 CTRL/C 1 





2.6.34 Changing the Threshold for Resuming Output-Stalled Jobs 

You can improve system throughput by changing the threshold for resuming output- 
stalled jobs. In an RT-11 system, a job is placed in a stalled state whenever it has 
terminal output to print but there is no room in its terminal output ring buffer. 
The system restarts the job when room becomes available in that ring buffer. The 
system's default mode of operation is to restart the job as soon as a single character 
of space is available. If more than one job is running, this mode of operation can 
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cause the system to spend much time swapping in the context of a job, simply to 
have it output a single character and then stall again. 

You can patch the monitor so that a job that is stalled while waiting for room in 
the terminal output buffer does not resume execution until several characters are 
available in the ring buffer. If you have a foreground or system job that produces a 
large amount of terminal output, installing this change can greatly improve system 
throughput. 

In the following customization, monitr.SYS is the name of the monitor file that you 
want to modify, ..TTON is the value of that symbol from the monitor link map, and 
nnn is the threshold value for resuming a terminal output-stalled job. 

The monitor will resume such a job when there are nnn-1 characters left to print 
in the output ring. The default value, SOg, is the size of the ring; consequently, the 
monitor resumes a job when 478 characters are left to print (that is, when only one 
character position is available in the output ring). You can specify any value from 1 
to the size of the output ring buffer (which is normally octal 50). Note that a value 
of 1 will cause the job to stay stalled until its ring buffer is empty. 



.RUN SIPP Iret 






*monitr.SYS |ret| 






Base? |ret| 






Offset ? . . TTON 1 RET 1 






Base Offset 


Old 


New? 


000000 . . TTON 


?????? 
?????? 


nnn \ ret 


000000 . . TTON+2 


CTRL/Y 1 1 RET 1 


* 1 CTRL/C 1 





2.6.35 Changing the Default Number of Directory Segments 

You can change the number of directory segments DUP creates when you initialize 
a volume. Normally, DUP uses the default number of directory segments, which 
depends on the size of the volume. (Refer to the RT-11 System Utilities Manual.) In 
other words, when you use the INITIALIZE command to initialize a volume, DUP 
ascertains the size of the volume and checks a table (within DUP) to establish the 
number of directory segments to use. This table consists of two-word entries that 
give a size and the number of segments. DUP searches the table until it finds a size 
larger than or equal to the size of the volume being initialized and uses the value 
in the following word as the number of directory segments. 

If the default number of directory segments for a volume is unacceptable for your 
application, you can use the /SEGMENTS:n option with INITIALIZE to initiahze 
a volume with n directory segments. (Refer to the RT-11 Commands Manual.) 
However, if you want DUP to use a specific number, you can modify DUP to change 
DUP's directory segment table (duplicated in the following). 
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/Volumes with <= 512. blocks 

;get 1 segment directories 

; Volumes with <= 2048. blocks 

;get 4 segment directories 

; Volumes with <= 12288. blocks 

;get 16. segments 

/Volumes with <= 65535. blocks 

; get 31 . segments 

; Expansion space for finer variations 

;Must be 0. 

In the customization, nnnnnn is an octal offset value from the table below. The 
value mmmmmm is an octal number (in the range 1 to 37) for the number of 
directory segments you want as the default. Find the size of the volume for which 
you are changing the default number of directory segments in the table. Enter the 
corresponding offset value in nnnnnn. Then, enter the number of default directory 
segments you want in mmmm. 



WORD 


1000 


WORD 


1 


WORD 


4000 


WORD 


4 


WORD 


30000 


WORD 


20 


WORD 


177777 


WORD 


37 


BLKW 


10. 


WORD 






Size of Volume in Blocks 
(decimal) 



Offset Value (octal) 



<=512 
<=2048 
<=12288 
<=65535 



000002 
000006 
000012 
000016 



.R SIPP [ret] 
*DUP.SAV [ret] 
Segment ? 10 [ret] 
Base ? SEGTBL |ret| 

Offset ? nnnnnn 



Segment 
000010 


Base 
SEGTBL 
SEGTBL 


Offset 
nnnnnn 
nnnnnn+2 


Old 
<??????> 
<??????> 


New? 
mmmmmm ret 


000010 

* |CTRL/C| 


1 CTRL/Y 1 1 RET 1 



2.6.36 Changing the Banner Page Width 

You can modify QUEUE to change the width of the banner page on printer output 
from 132 positions to 80 positions. 

In the customization, ..NBl, ..NB2, and ..NB3 are the values of those symbols from 
the link map. 

.RUN SIPP [ret] 
*QUEUE.REL/A [rH] 
Base? I RET I 

Offset ? . . NBl [ret] 



Base 
000000 



Offset 
. .NBl 



Old 
■?■?■? 



New? 

\ [m] 
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Base Offset 
000000 . .NBl 
000000 . .NBl+1 
000000 . .NBl+2 
000000 . .NBl+3 



Offset ? 



.NB2 [ret] 



Base Offset 
000000 . .NB2 

Base Offset 
000000 . .NB2 
000000 . .NB2+1 
000000 . .NB2+2 



Offset ? 



.NB3 [ret] 



Base Offset 

000000 . .NB3 
000000 . .NB2+2 



Old 


New? 


??? 


15 |RET| 


??? 


12 |ret| 


??? 


IretI 


??? 


1 CTRUZ 1 1 ret 1 


Old 


New? 


??? 


\ 1 FiET 1 


Old 


New? 


??? 


15 |RET| 


??? 


12 |RET| 


??? 


CTRL/Z 1 1 RET 1 


Old 


New? 


?????? 


240 |ret 


?????? 


CTRL/Y 1 1 RET 1 



2.6.37 Modifying Listing Page Length in LINK 

If you do not use printer paper of a standard size (10.5 inches long) or if your 
configuration does not include a printer, you can modify the listing page length 
in LINK. RT-11 LINK sets the number of lines printed on each listing page at 60. 
This line count is generally satisfactory only for applications with printers that use 
paper 10.5 inches long. You may require a listing of a different length. In the 
customization, LINPPG is the value of that symbol in the link map, and nnn is the 
desired listing page length (in lines). 

.RUN SIPP [ret] 
*LINK.SAV [ret] 
Segment? |ret| 
Base? I RET I 

Offset? LINPPG [rIi] 



Segment 
000000 


Base 
000000 
000000 


Offset 
LINPPG 
LINPPG+2 


Old 
■? 

■p 


New? 

nnn \ ret | 


000000 

* 1 CTRL/C 1 


1 CTRLA' I 1 RET 1 



2.6.38 Assigning the HELP File 

You can assign your HELP file to a file and/or device other than SYHELPSAV. 

In the customization, monitr.SYS is the name of the monitor file that you wish to 
modify, and ..HELF is the value of that symbol from the monitor link map. The 
RAD50 file specification starts at ..HELF. 

.RUN SIPP [ret] 
*monitr.SYS |ret| 
Base? I RET I 

Offset ? . . HELF [RfLJ 
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Base Offset 


Old 


New? 


000000 


.HELF 


?????? 


;R IRETI 


000000 


.HELF 


<SY > 


;Rdev |ret| 


000000 


. HELF+2 


<HEL> 


;Rf±l |ret| 


000000 


. HELF+4 


<P > 


/ Rnam \ ret | 


000000 


.HELF +6 


<SAV> 


; Rext 1 RET 1 


000000 


.HELF+10 


<???> 


CTRL/Y 1 RET | 


1 CTRUC 1 





2.6.39 Changing the Device from Which IND.SAV Is Run 

By default, the system runs IND.SAV from SY when KMON is set to IND and you 
type @filnam. To change the device from which the IND.SAV file is run, change the 
contents of ..INDN to the RAD50 device name of the device from which IND will 
be run. For example, to run IND from the virtual device (VM), open the ..INDN 
location in the link map and change its contents to VM. 

In the customization, monitr.SYS is the name of the monitor file that you wish to 
modify, and ..INDN is the value of that symbol from the monitor link map. 

.RUN SIPP [ret] 
*mon±tr.SYS |ret| 
Base? I RET I 

Offset ? . . INDN [ret] 

New? 

;R [ret] 
;Rdev I RET I 

CTRL7Y I RET I 



Base 


Offset 


Old 


000000 


. . INDN 


?????? 


000000 


. . INDN 


<SY > 


000000 


. . INDN+2 


<IND> 


1 CTRUC 1 





2.6.40 Supporting Bad Blocl( Replacement in User-Written Handlers 

If a user- written handler supports bad block replacement, you must apply one of the 
following customizations. If all bad blocks are replaceable (such as the RLOl/02), 
apply customization A. If only bad sector errors are replaceable (such as the RK06 
/07), apply customization B. 

Customization A 

.R SIPP [ret] 
*DUP.SAV [ret] 
Segment ? 1 |ret| 
Base? I RET I 

Offset? ARDPS 



Segment 


Base 


Offset 


Old 


New? 


000001 


000030 


ARDPS 


??? 


377 |RET| 


000001 


000030 


ARDPS+1 


??? 


1 CTRL/y 1 1 RET 1 


* |CTRL/C| 
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Customization B 








.R SIPP 


|ret| 








*DUP . SAV 


|ret| 








Segment ? 


1 |Ret| 








Base? 


|ret| 








Offset ? 


SRDPS 


|ret| 






Segment 


Base 


Offset 


Old 


New? 


000001 


000000 


SRDPS 


?????? 


\ 1 RET 


Segment 


Base 


Offset 


Old 


New? 


000001 


000000 


SRDPS 


??? 


377 |RET| 


000001 


000000 


SRDPS+1 


??? 


1 CTRL/Y 1 1 R 


* |CTRL/C| 











2.6.41 Supporting User-Written Magtape Handlers 

If a user-written magtape handler is used, you must apply the following three 
customizations. All three customizations assume that the device code for the device 

is 3778- 

Customization 1 

.R SIPP [ret] 
*DUP.SAV [ret] 
Segment ? 1 |ret| 
Base? I RET I 

Offset? MTDPS [ret] 

Segment 
000001 

Segment 

000001 

000001 



ase 


Offset 


Old 


New? 


000000 


MTDPS 


?????? 


\ 1 RET 


ase 


Offset 


Old 


New? 


000000 


MTDPS 


??? 


377 |RET| 


000000 


MTDPS+1 


??? 


1 CTRL/Y 1 1 RET | 



Customization 2 

.R SIPP [ret] 
*PIP.SAV [ret] 
Segment ? 1 |ret| 
Base? I RET I 

Offset? PIPMT [ret] 

Segment 
000001 

Segment 

000001 

000001 



ase 


Offset 


Old 


New? 


000000 


PIPMT 


??? 


\ [m] 


ase 


Offset 


Old 


New? 


000000 


PIPMT 


??? 


377 |RET| 


000000 


PIPMT+1 


??? 


1 CTRUY 1 1 RET 1 
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Customization 3 

.R SIPP [ret] 
*MDUP.SAV [r13 
Base? I RET I 

Offset ? MDUPMT 



Base 


Offset 


Old 


New? 


000000 


MDUPMT 


??? 


\ 1 RET 1 


Base 


Offset 


Old 


New? 


000000 


MDUPMT 


??? 


377 |RET 


000000 


MDUPMT+1 


??? 


CTRL/Y 1 1 RET 1 


1 CTRL/C 1 





2.6.42 Eliminating or Changing the IND Control File Terminating Message 

You can eliminate or change the terminating message of IND control files, using the 
following customization patch. 

The terminating message in the distributed IND is '@ <EOF>'. That message 
appears whenever IND exits and returns control. You can eliminate that message 
by specifying only a null character or change that message by specifying up to 7 
characters plus the null character. 

In the customization, ..INEO is the symbol for a value located in the file 
CUSTOM.TXT, and each n is an ASCII character in the new message. The required 
null character is an octal 0. 

.RUN SIPP [ret] 
*IND.SAV [ret] 
Segment ? |ret| 
Base? I RET I 

Offset ? . . INEO [rHI 



Segment 


Base 


Offset 


Old New? 


000000 


000000 


. . INEO 


?????? 


A 1 ret 1 


000000 


000000 




.INEO 


<@> 


An 1 ret 1 


000000 


000000 




. INEO+1 


< > 


An 1 RET 1 


000000 


000000 




. INEO+2 


«> 


An 1 RET 1 


000000 


000000 




. INEO+3 


<E> , 


An 1 RET 1 


000000 


000000 




. INEO+4 


<0> 


An 1 RET 1 


000000 


000000 




. INEO+5 


<F> 


An 1 RET 1 


000000 


000000 




. INEO+6 


<» 


An RET 


000000 


000000 




.INEO+7 


??? 


RET 


Segment 


Base 


Offset 


Old I 


Hew? 


000000 


000000 


. . INEO+6 


?????? 


\ |ret| 


Segment 


Base 


Offset 


Old I 


few? 


000000 


000000 
000000 


. . INEO+6 
. .INEO+7 


??? |ret| 
??? i 




000000 


J 1 CTRL/Y 1 


* 1 CTRL/C 1 
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2.6.43 Changing Default File Type of Logical Disk Files 

By default, the file type of logical disk files is .DSK. You can alter the default file 
type in one of two ways. (Note that the same procedures also apply to LDX.SYS for 
the XM monitor.) 

Customization 1 

Edit the conditional file SYSGEN.CND and add the following line where typ is the 
desired default file type: 

DEF$LD = "^Rtyp ; define default for LD filetype 

Then, reassemble and rehnk LD.SYS by using the conditional file SYSGEN.CND. 

Customization 2 

Do the following customization patch: 

.UNPROTECT SY: LD.SYS \r^ 
.R SIPP [ret] 
*SY:LD.SYS/A [^ 
Base? . .LDEX [ret] 

Offset? [ret] 

New? 

;R [ret] 
;Rtyp [ret] 
;Rtyp [ret] 
;Rtyp [ret] 
;Rtyp [ret] 

CTRL/Y I RET I 



Base Offset 


Old 


000000 


.LDEX 


?????? 


000000 


.LDEX 


<DSK> 


000000 


. LDEX+2 


<DSK> 


000000 


. LDEX+4 


<DSK> 


000000 


.LDEX+6 


<DSK> 


000000 


.LDEX+10 


?????? 


1 CTRUC 1 





2.6.44 Changing QUEUE to Allow First Form Feed 

QUEUE suppresses the first form feed in a file, because QUEUE assumes that the 
LP or LS handler is set to FORMO, which generates a form feed. If the printer 
handler is set to NOFORMO, no form feed is generated. 

You can apply the following customization so that QUEUE will never suppress the 
initial form feed in a file. If you apply this customization and set your printer handler 
to FORMO, an extra blank page will be produced. 

In the customization, ..DOFF is the value of that symbol from the file CUSTOM.TXT 
on your distribution kit. 

.RUN SIPP [ret] 
*QUEUE.REL \^] 
Base? I RET I 
Offset ? . . DOFF [ret] 

New? 

240 [ret] 
240 [rfH 
ctrl/y i ret i 



Base 


Offset 


Old 


000000 


. .DOFF 


?????? 


000000 


. .DOFF+2 


?????? 


000000 


. . DOFF+4 


?????? 


1 CTRUC 1 
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2.6.45 Changing Listing Page Length in MACRO and CREF 

The default listing page size for MACRO and CREF, 60 lines long, is suitable for 
printers that use standard size printer paper (10.5 inches long). If you use printer 
paper that is not standard size, or if your configuration does not include a printer, 
you may need to modify the listing page length in MACRO and CREF. In the 
customizations, nnn represents the desired listing page length (octal). Substitute 
for the symbol PGSIZE the value of that symbol given in the file CUSTOM.TXT on 
your distribution kit. 

To modify MACRO: 

.RUN SIPP [ret] 
*MACRO.SAV [ret] 
Segment ? |ret| 
Base? I ret I 

Offset? PGSIZE [rIi] 



Segment 
000000 


Base 
000000 
000000 


Offset 
PGSIZE 
PGSIZE+2 


Old 
?????? 
?????? 


New? 

nnn \ ret | 


000000 

* 1 CTRL/C 1 


1 CTRL/Y 1 1 RET 1 



To modify CREF: 

.RUN SIPP [ret] 
*CREF.SAV [r13 
Base? [rH] 

Offset? PGSIZE [rIi] 

Base Offset 

000000 PGSIZE 
000000 PGSIZE+2 



Old 
?????? 
■?■?■?■?■?■? 



New? 

nnn I ret 

CTRL/Y I RET I 



2.6.46 Changing Default Command File Processor to IND 

In the distributed monitors, the default command file processor is KMON. Apply 
the following customization to change the default command file processor to IND. 
After you have applied this customization, you may use an IND control file as your 
start-up command file, providing the file IND.SAV resides on your system volume. 

In the customization, monitr.SYS is the monitor file you want to modify, and ..INDR 
is the value of that symbol from the appropriate monitor link map. If the monitor 
you customize is hardware bootable, write a new system bootstrap with the COPY 
/BOOT command. 

.RUN SIPP [ret] 
*mon±tr.sys |ret| 
Base? I RET I 

Offset ? . . INDR 
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Base 


Offset 


Old 


New? 


000000 


. . INDR 


?????? 


1 1 RET 1 


000000 


. . INDR+2 


?????? 


CTRL/Y 1 1 RET 1 


1 CTRL/C 1 





If you do not wish to apply this customization, you can set the default command file 
processor to IND by setting the conditional IND$ON to 1 in the conditional file. 

2.6.47 Limiting Amount of Memory KEX Requests 

KEX, by default, requests all available 16-bit memory up to 32K words. This 
customization allows you to limit the amount of memory KEX requests with a 
.SETTOP programmed request. 

In the customization, the symbol ..MAXM represents the highest address KEX will 
request. (In the distributed monitors, this value is set to 177776, the highest address 
possible.) If you set this value too low, KEX will fail and print the error message 
?KEX-F -Insufficient memory. You can find the correct value for the symbol ..MAXM 
in the file CUSTOM.TXT on your distribution kit. Replace the symbol nnnnnn with 
the new maximum address value you want KEX to request. 



.R SIPP |RET| 

*KEX.SAV |ret| 
Segment ? | ret | 
Base ? 1 RET 1 
Offset? . .MAXM |RET| 

Base Offset 
000000 . .MAXM 


Old 
?????? 
?????? 


New? 

; nnnnnn \ ret | 


000000 . .MAXM+2 


CTRL/Y 1 RET | 


* 1 CTRL/C 1 





2.6.48 Changing MACRO'S Default .LIST/.NLIST Options 

MACRO-11 is distributed with the following .NLIST defaults: 

.NLIST LD,ME,MEB,TTM 

You may change the .NLIST defaults to any of the following, where the following bit 
significance applies (bit asserted implies ".NLIST"): 

BEX= 2 

BIN= 4 

CND = 10 

COM = 20 

HEX = 40 

LOG = 100 

MC = 200 

MD = 400 

ME = 1000 

MEB = 2000 
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SEQ = 4000 

SRC = 10000 

SYM = 20000 

TOC = 40000 

TTM = 100000 

.RUN SIPP [ret] 
*MACRO.SAV [ret] 
Segment ? I ret 
Base? I RET I 

Offset ? LCBITS 



Base 
000000 


Offset 
LCBITS 
LCBITS+2 


Old 
?????? 
?????? 


New? 
nnnnnn \ ret | 


000000 


CTRL/Y 1 RET | 


1 CTRL/C 1 





2.6.49 Changing MACRO'S Default .ENABLE/.DISABLE Options 

MACRO-11 is distributed with the following .DSABL defaults: 

.DSABLABS,AMA,CDR,DBG,FPT,LCM,LSB,MCL 

You may change the .DSABL defaults to any of the following, where the following 
bit significance applies (bit asserted implies ".DSABL"): 



ABS = 


1 


AMA = 


2 


CDR = 


10 


CRF = 


20 


DBG = 


40 


FPT = 


100 


GBL = 


200 


LC = 


400 


LCM = 


1000 


LSB = 


2000 


MCL = 


4000 


PNC = 


10000 


REG = 


20000 



.RUN SIPP 
*MACRO.SAV [ret] 
Segment ? I ret 
Base? I RET I 

Offset ? EDBITS 

Base Offset Old New? 

000000 EDBITS ?????? nnnnnn [ret] 

000000 EDBITS+2 ?????? ctruy |ret| 



CTRUC 
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2.6.50 Modifying KED Default File Type 

KED supports default file types. When editing a file, the default input file type is 
.MAC; the default output file type is the same as the input file type. When inspecting 
a file, the default input file type is .LST. There is no default input file type when 
creating a file. 

To specify a file with no file type, type only the file name and the period separating 
the file name and type (FILNAM.). 

You can modify the default file types with the following software customization. In 
the customization, substitute KED or KEX for aaa. Substitute the value for the 
symbol ..EEXT (for the editing-file default) or ..lEXT (for the inspecting-file default) 
for bbbbbb. These values can be found in CUSTOM.TXT on your distribution kit (be 
sure to use the proper KED variant). Substitute the three-character file type default 
you want for ccc. 



.R SIPP |RET| 






*aaa.SAV/A |ret| 






Base? |ret 






Offset? bbbbbb |ret| 






Base Offset 


Old 


New? 


000000 bbbbbb 


?????? 


;R iRETl 


000000 bbbbbb 


<???> 


/ RCCC 1 RET 1 


000000 bbbbbb 


<???> 


CTRL/Y 1 RET | 



CTRL/C 



2.6.51 Changing SPOOL'S Work File Size 

SPOOL allocates by default 1024io blocks on logical device SFD or SY for its work 
file SPOOL.SYS. You can change the default size of SPOOL.SYS by applying the 
following software customization. In the customization, ..SPSZ is the offset for the 
current number of blocks SPOOL allocates for its work file. Substitute for ..SPSZ 
the value provided in the file CUSTOM.TXT. nnnnnn is the number (octal) of blocks 
you want SPOOL to allocate for its work file. 

.RUN SIPP [ret] 
*SPOOL.REL/A [rIi] 
Base? I RET I 

Offset ? . . SPSZ [rIi] 



Base 
000000 


Offset 
. . SPSZ 
. . SPSZ+2 


Old 
?????? 
?????? 


New? 
nnnnnn \ ret | 


000000 


CTRL7Y 1 1 RET 1 


1 CTRUC 1 





If there is not enough room on the volume for a work file of the default size, 
SPOOL.SYS occupies the largest empty area on the volume. 
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2.6.52 Changing SPOOL'S Output Device 

You can change SPOOL'S default output device to any RT-11 non-file-structured 
device by installing the following software customization. In the customization, 
substitute for ..SPSO the value provided in the file CUSTOM.TXT. nnn is the new 
output device's mnemonic. 

.RUN SIPP [ret] 
*SPOOL.REL/A [rIi] 
Base? I RET I 

Offset ? . . SPSO [ret] 

New? 

;R [ret] 
; Rnnn |ret| 

CTRL/Y I RET I 



2.6.53 Changing LINK for Default 132-Column Link Map and Global 
Cross-Reference Table 

You can change the link map and global cross-reference table to default to 
132 columns, rather than 80 columns. The value of ..WDSZ can be found in 
CUSTOM.TXT on your distribution kit. 



Base 


Offset 


Old 


000000 


. . SPSO 


?????? 


000000 


. . SPSO 


<LP> 


000000 


. . SPSO+2 


?????? 


|CTRL/C| 





.RUN SIPP 


JRET 








*LINK. SAV 


JRET 








Segment? J 


[ JRETJ 








Base? JRETJ 








Offset ? . . 


WDSZ JRETJ 








Segment 


Base 


Offset 


Old 


New? 


000001 


000000 


. .WDSZ 


?????? 


000006 IRETJ 


000001 


000000 


. . WDSZ+2 


?????? 


1 CTRLA' 1 1 RET 1 


* 1 CTRL/C 1 











2.6.54 Changing Default Size of MACRO-11 Work File 

You can tailor the size of the MACRO-11 work file. If the work file is too small, 
a program that uses a great many symbols or macros can cause the work file to 
overflow and return the error message ?MACRO-F-Storage limit exceeded. A work 
file that is too large may not fit on a small device such as VM. 

In the customization, nnn represents the size of the work file and can be a value 
between 128 and 256io. WRKSIZ is the symbol for the value given in the file 
CUSTOM.TXT on your distribution kit. 

.R SIPP [ret] 
*MACRO.SAV [ret] 
Segment ? |ret| 
Base? I RET I 

Offset? WRKSIZ 
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Segment 
000000 


Base 
000000 
000000 


Offset 
WRKSIZ 
WRKSIZ+2 


Old 
?????? 
?????? 


New? 

nnn ret 


000000 

* 1 CTRL/C 1 


1 CTRLA' 1 1 RET 1 



2.6.55 Changing Name and Default Device for UCL.DAT 

You can change the name of the UCL data file. With this patch, you can also change 
the default device on which the UCL data file resides. 

The file specification for the UCL data file is stored in four RAD50 words. The first 
word is the device name without the colon (:). You must leave a trailing space if 
you use a 2-letter device name. The second word is the first three letters of the file 
name. The third word is the second three letters of the file name (if required). The 
fourth word is the file type. Do not include the period (.) between the file name and 
file type. 

In the customization patch, ..UCLD is the symbol for the first RAD50 word. 
Substitute for ..UCLD the value for that word found in the file CUSTOM.TXT on 
your distribution kit. Substitute for nnn each part of the file specification that you 
changed when you created a new UCL data file. 

.R SIPP [ret] 
*UCL.SAV/A [rIi] 
Base? I ret I 

Offset ? . . UCLD [rIi] 



Base Offset 


Old 


New? 


0000 


.UCLD 


?????? 


;R |RET| 


0000 


.UCLD 


?????? 


; Rnnn 1 ret | 


0000 


. UCLD+2 


?????? 


; Rnnn 1 ret | 


0000 


. UCLD+4 


?????? 


; Rnnn | ret | 


0000 


. UCLD+6 


?????? 


; Rnnn \ ret | 


0000 


. UCLD+1 


?????? 


CTRL/Y 1 1 RET 1 


1 CTRL/C 1 





2.6.56 Suppressing Dynamic Allocation of a Region for IND 

IND dynamically allocates a region in extended memory for its symbol table when 
running RT-11 under a mapped monitor. You can suppress the dynamic allocation 
by using the following customization. 

In the customization, ..ALRG is the symbol for the value given in the file 
CUSTOM.TXT on your distribution kit. Enter the value (zero) for symbol n to 
suppress the dynamic allocation. Enter the value 1 for n to dynamically allocate a 
region. 

.R SIPP [ret] 
*IND.SAV [ret] 
Segment ? |ret| 
Base? I RET I 

Offset ? . . ALRG 
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Segment 


Base 


Offset 


Old 


New? 


000000 


000000 


. .ALRG 


?????? 


n 1 RET 1 


000000 


000000 


. .ALRG+2 


?????? 


1 CTRL/Y 1 1 RET 1 


* 1 CTRL/C 1 











2.6.57 Changing Size of UCL.DAT 

You can change (increase or decrease) the maximum number of user-defined UCL 
commands in the UCL data file from 31io to a maximum you specify. Perform 
the following customization patch to change the size of UCL.DAT. (Refer to the 
Introduction to RT-11 for more information on UCL.) 

In the customization patch, replace the symbol ..CMDS with the value given in the 
file CUSTOM.TXT on your distribution kit. Replace nnnnn with an octal value for 
the maximum number of defined (UCL) commands you want. 

.R SIPP [ret] 
*UCL.SAV/A [rIi] 
Base? I RET I 

Offset ? . . CMDS [rIi] 



Base 
000000 
000000 


Offset 
. .CMDS 
. . CMDS+2 


Old 

?? 

?????? 


New? 
nnnnn 

CTRL/Y 


|ret| 
|ret| 


1 CTRL/C 1 





2.6.58 Changing Default VTCOM Send Speed 

The VTCOM SEND command sends ASCII files at two speeds: SLOW or FAST. Use 
SLOW if the host terminal service does not support XON/XOFF and use FAST if it 
supports XON/XOFF The default speed is SLOW. 

The following customization patch lets you set the default speed at which VTCOM 
sends ASCII files. In the customization, ..FAST is the symbol for the value given in 
the file CUSTOM.TXT on your distribution kit. Set the value for n to 1 to specify 
FAST. 



For VTCOM.REL: 






.R SIPP |REt| 






*VTCOM.REL |ret| 






Base? |ret| 






Offset? . .FAST |RET| 






Base Offset 


Old 


New? 


000000 . .FAST 


?????? 


n 1 RET 1 


000000 . . FAST+2 


?????? 


CTRL/Y 1 RET | 


* 1 CTRUC 1 





2-54 RT-11 Installation Guide 



For VTCOM.SAV: 






.R SIPP |ret| 
*VTCOM.SAV |RET| 
Segment? 1 |ret| 
Base? |ret| 
Offset? . .FAST |ret| 






Segment 

000001 

000001 


Base Offset 
000000 . .FAST 
000000 . .FAST+2 


Old 
?????? 
?????? 


New? 

n 1 RET 1 

1 CTRL/Y 1 1 RET | 


* 1 CTRL/C 1 









2.6.59 Modifying System Macro Library SYSMAC.SML 

To modify the system macro library, recreate the file SYSMAC.MAC from the 
distributed file SYSMAC.SML by using the SPLIT utility. 

The following command creates the file SYSMAC.MAC on your default device. The 
symbol ..SYSM represents the boundary along which to split SYSMAC.SML. Refer to 
the file CUSTOM.TXT on your distribution kit for the value to substitute for ..SYSM 
in the command line. 

. SPLIT , SYSMAC . MAC=SYSMAC . SML/B : . . SYSM [Rfr] 

Refer to the RT-11 System Utilities Manual for more information on using the SPLIT 
utility. 

2.6.60 Modifying VTCOM Default Dial String Prefix 

The default VTCOM dial string prefix is '^A^B. Perform the following customization 
patch if your modem requires a different dial string prefix. Consult your modem 
user guide for the correct prefix. 

VTCOM first sends the dial string prefix and then sends the dial string. This patch 
does not affect the dial string. 

In the customization, ..DPFX is the symbol for the value given in the file 
CUSTOM.TXT on your distribution kit, and nnn is the octal value for each ASCII 
character in the dial string prefix. Insert a null (000) in the location immediately 
following the last character in the dial string prefix. The prefix cannot be longer 
than 15 characters. The sixteenth byte must be a null. 

For VTCOM.REL: 

.R SIPP [ret] 
*VTCOM.REL [rIi] 
Base? I RET I 

Offset ? . . DPFX [rIi] 
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Base 


Offset 


Old 


New? 


000000 


. .DPFX 


??? 


nnn | ret 


000000 


. .DPFX+1 


??? 


nnn \ ret 


000000 


. .DPFX+1 6 
. .DPFX+17 


??? 
??? 


nnn \ ret 


000000 


CTRL/Y 1 RET | 


1 CTRL/C 1 





For VTCOM.SAV: 

.R SIPP [ret] 
*VTCOM.SAV [ret] 
Segment? 1 |ret| 
Base? I RET I 

Offset ? . . DPFX 



Segment 

000001 

000001 



Base 
000000 
000000 



Offset 
. .DPFX 
. .DPFX+1 



Old 
??? 
■?■?■? 



New? 

nnn |ret| 
nnn |ret| 



000001 
000001 



000000 
000000 



. DPFX+1 6 
. DPFX+1 7 



??? 
■?■?■? 



nnn |ret| 

I CTRL/Y I I RET I 



2.6.61 Modifying VTCOM Default Dial String Suffix 

The default dial string suffix is an exclamation ( ! ) mark (041). Some modems require 
a different dial string suffix following the digits of the number to be dialed. Refer 
to your modem user guide for any required dial string suffix. Perform the following 
customization patch if your modem requires a different dial string suffix. 

In the customization, ..DSFX is the symbol for the value given in the file 
CUSTOM.TXT on your distribution kit, and nnn is the octal value for each ASCII 
character in the dial string suffix. Insert a null (000) in the location immediately 
following the last character in the dial string suffix. The suffix cannot be longer 
than 15 characters. The sixteenth byte must be a null. 

For VTCOM.REL: 

.R SIPP [ret] 
*VTCOM.REL [rIi] 
Base? I RET I 

Offset ? . . DSFX 
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Base 


Offset 


Old 


New? 


000000 


. .DSFX 


??? 


nnn | ret 


000000 


. .DSFX+1 


??? 


nnn \ ret 


000000 


. .DSFX+1 6 
. .DSFX+17 


??? 
??? 


nnn \ ret 


000000 


CTRL/Y 1 RET | 


1 CTRL/C 1 





For VTCOM.SAV: 

.R SIPP [ret] 
*VTCOM.SAV [ret] 
Segment? 1 |ret| 
Base? I RET I 

Offset ? . . DSFX [rIi] 



Segment 


Base 


Offset 


Old 


New? 


000001 


000000 


. . DSFX 


??? 


nnn \ ret | 


000001 


000000 


. . DSFX+1 


??? 


nnn \ ret | 


000001 


000000 
000000 


. . DSFX+1 6 
. . DSFX+1 7 


??? 
??? 


nnn ret 


000001 


1 CTRL/Y 1 1 RET 1 



2.6.62 Automatically Creating KED/KEX Journal Files 

The following customization patch automatically creates a journal file on the default 
data (DK) device for every work session. 

In the customization, ..JOU is the symbol for a value located in the file 
CUSTOM.TXT. 



For KED.SAV: 

.RUN SIPP [ret] 
*KED.SAV [ret] 
Segment ? 6 |ret| 
Base? I RET I 

Offset ? . . JOU \^\ 



Segment 


Base 
000000 


Offset 
. .JOU 


Old 
?????? 


New? 


000006 

* 1 CTRL/C 1 


1 1 CTRL/Y 1 



For KEX.SAV: 

.RUN SIPP [ret] 
*KEX.SAV [ret] 
Segment ? 1 |ret| 
Base? I RET I 

Offset ? . . JOU [rIi] 
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Segment 


Base 
000000 


Offset 
. .JOU 


Old 
?????? 


New? 


000001 

* 1 CTRL/C 1 


1 1 CTRL/Y 1 



2.6.63 Adjusting Default KED/KEX Journal File Size Allocation 

By default, KED/KEX allocates 50 lo blocks on the default or specified device for 
journal files. You can adjust the default number of allocated blocks, using the 
following customization patch. 

In the customization, ..JSIZ is the symbol for a value located in the file 
CUSTOM.TXT. The symbol nnn represents the number of octal blocks you want 
to allocate as the default journal file size (62 octal blocks equal 50 decimal blocks). 



For KED.SAV: 








.RUN SIPP 
*KED . SAV 
Segment ? 
Base? 
Offset ? 


|ret 
|ret| 
|ret| 
|ret| 

. .JSIZ |RET| 








Segment 
000000 


Base 
000000 


Offset 
. . JSIZ 


Old 
?????? 


New? 

nnn | ctrl/y | [f 


* 1 CTRL/C 1 










For KEX.SAV: 








.RUN SIPP 
*KEX. SAV 
Segment ? 
Base? 
Offset ? 


|ret 
|ret| 

1 1 RET 1 
1 RET 1 
. .JSIZ |RET| 








Segment 
000001 


Base 
000000 


Offset 
. . JSIZ 


Old 
?????? 


New? 

nnn \ ctrl/y 


* 1 CTRL/C 1 











2.6.64 Creating a Monitor-Independent ODT Debugger 

The following procedure lets you create a monitor-independent ODT debugger; that 
is, an ODT that does not require that the operating system be loaded in memory. 

The distributed debugger ODT.OBJ needs the operating system loaded in memory. 
You can modify ODT so it does not need the operating system loaded in memory, 
which could be useful, for example, in debugging the bootstrap. 

Use the following procedure to create a debugger called ODTHWD.OBJ that 
functions independently of the operating system: 

1. Use KED to create the following patch program. Name it ODTPATMAC. In the 
program, substitute for the symbol ..GVAL the value for that symbol located in 
the file CUSTOM.TXT. 
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. TITLE ODT 
. PSECT $ODT$ 
BASE= . . GVAL-1 000 
.=.+BASE 
BR . +34 

.END 

2. Assemble the created patch program: 

.R MACRO [ret] 
*ODTPAT=ODTPAT [ret] 

* [ctrl/c I 

3. Create the monitor-independent debugger ODTHWD.OBJ by modifying 
ODT.OBJ, which does not destroy the distributed ODT.OBJ but modifies a copy 
of it. Use the utihty PAT.SAV in the following manner: 

.R PAT RET 
*ODTHWD=ODT,ODTPAT [ret] 

* I CTRL/C I 



4. Explicitly specify ODTHWD in the LINK/DEBUG command. If you do not specify 
ODTHWD, RT-11 by default links the distributed ODT. 

. LINK/DEBUG : ODTHWD program [Rfr] 

2.6.65 Forcing an Explicit KED/KEX Journal File Device 

By default, KED/KEX creates a requested journal file on the DK device or a device 
you specify on the command line. You can force KED/KEX to create any requested 
journal file on a specified device, using the following customization patch. Note that 
if the customization is performed, KED/KEX creates a journal file on only the device 
specified in the customization; any device specified in the command line is ignored. 
Further, if the specified device cannot be found, a journal file is not created and 
KED/KEX returns an error message. 

In the customization, ..JDEV is the symbol for a value located in the file 
CUSTOM.TXT. The symbol rrr represents the RAD50 value for the journal file 
device. 



For KED.SAV: 






.RUN SIPP 
*KED.SAV 
Segment ? 
Base? 
Offset ? 


|ret 
|Ret| 
|ret| 
|ret| 
. . JDEV 1 RET 1 






Segment 
000000 


Base Offset 
000000 . .JDEV 
000000 . .JDEV 


Old 
?????? 
?????? 


New? 

} R 1 RET 1 


000000 


; rrr 1 ctruy | 


* 1 CTRL/C 1 









\m} 
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For KEX.SAV: 






.RUN SIPP 
*KEX. SAV 
Segment ? 
Base? 
Offset ? 


|ret 
|ret| 
1 |Ret| 
|ret| 
. .JDEV |RET| 






Segment 
000001 


Base Offset 
000000 ..JDEV 
000000 ..JDEV 


Old 
?????? 
?????? 


New? 

; R 1 RET 1 


000001 


; rrr 1 ctruy | 


* 1 CTRL/C 1 









[ml 



2.6.66 Modifying the Storage Capacity for LEARN Macros 

By default KED/KEX allocates 512io locations for storing LEARN macros. That 
storage area is shared by up to 8 macro definitions. You can modify that storage 
capacity by performing the following customization. Increasing the storage capacity 
decreases the amount of memory available for paste buffer space and general file 
editing. Therefore, ask only the amount of storage capacity you require. 

In the customization, ..MACS is the symbol for a value located in the file 
CUSTOM.TXT. The symbol nnnnnnn is the octal number of storage locations you 
want to support. 

For KED.SAV: 

.RUN SIPP [ret] 
*KED.SAV [ret] 
Segment ? |ret| 
Base? I RET I 

Offset ? . . MACS [ret] 

Offset Old New? 

^13 



Segment 


Base 
000000 


Offset 
. .MACS 


Old 
?????? 


New? 


000000 


nnnnnnn \ ctrl/y | 


* 1 CTRL/C 1 












For KEX.SAV: 










.RUN SIPP 


|ret 










*KEX. SAV 


|ret| 










Segment ? 
Base? 


1 |Ret| 
|ret| 










Offset ? 


. .MACS 


ret| 








.b 












Segment 


Base Offset 
000000 . .MACS 


Old 
?????? 


New? 


000001 


nnnnnnn \ ctrl/y | 


* 1 CTRUC 1 













\m\ 



2.6.67 Modifying the Maximum Number of LEARN Macros 

By default KED/KEX allows 8io LEARN macros to be defined at any one time. You 
can modify that limit by performing the following customization. 

In the customization, ..MACN is the symbol for a value located in the file 
CUSTOM.TXT. The symbol nn is the octal number of macros you want to define. 
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The maximum is support for 27io macro definitions, for which you would specify 
338. 

For KED.SAV: 

.RUN SIPP [ret] 
*KED.SAV [ret] 
Segment ? |ret| 
Base? I RET I 

Offset ? . . MACN [ret] 

Segment Base Offset Old New? 

000000 000000 . .MACN ?????? nnn |ctrl/y [ret] 



* 1 CTRL/C 1 




For KEX.SAV: 




.RUN SIPP |ret 
*KEX.SAV |ret| 
Segment? 1 |ret| 
Base? |ret| 
Offset? . .MACN |RET| 




Segment Base Offset 
000001 000000 . .MACN 


Old 
?????? 


* 1 CTRL/C 1 





New? 

nnn \ ctrl/y |ret| 



2.6.68 Restoring LOCAL Form Feed Processing 

The LOCAL command ignores the presence of form feeds in files that are being 
processed. If for some reason you wish to restore the previous way the LOCAL 
command treated form feeds in files, you can perform the following customization. 

In the customization, ..LCFF is the symbol for a value located in the file 
CUSTOM.TXT. 

For KED.SAV: 

.RUN SIPP [ret] 
*KED.SAV [rHI 
Segment ? |ret| 
Base? I RET I 

Offset ? . . LCFF [rHI 



Segment 


Base 
000000 


Offset 
. . LCCF 


Old 
?????? 


New? 
000014 






000000 

* 1 CTRL/C 1 


1 CTRL/y 1 


|ret| 



For KEX.SAV: 

.RUN SIPP [ret] 
*KEX.SAV [retI 
Segment ? 1 |ret| 
Base? I RET I 

Offset ? . . LCFF [rIi] 
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Segment 


Base 
000000 


Offset 
. . LCCF 


Old 
?????? 


New? 
000014 




000000 

* 1 CTRUC 1 


1 CTRL/Y 1 



\^m 



2.6.69 Removing the JSW Bit 6 Checl( for SL 

Previously, SL checked only the state of bits 4 (EDIT$) and 12 (TTSPC$) in the JSW 
(job status word). SL refused to edit a command line if either was set. SL did not 
check if a program had set bit 6 (TCBIT$), the inhibit terminal wait bit. SL could 
hang in the rare event that a program had set bit 6 and not set bit 12 and was using 
the .TTINR request in a loop to clear the input buffer. (KED is such a program.) 

SL checks the status of bits 4, 6, and 12 of the JSW. If a program sets any of those 
bits, SL does not edit command lines. 

Possible incompatibilities remain with SL editing of command lines written and 
retrieved using requests other than .GTLIN. Digital continues to recommend you 
use .GTLIN to display prompts and retrieve terminal input. 

If for some reason you require that SL ignore the status of bit 6 of the JSW, RT-11 
provides the following customization patches to remove that functionality. Three 
patches are provided, one for each version of the SL command line editor. In 
the customization patches, _..SLCN, ..SLCX, and ..SLCM are the values for those 
symbols located in the file CUSTOM.TXT. 



For SL.SYS: 






.RUN SIPP |ret 






*SL.SYS/A |ret 






Base? |ret| 






Offset? . .SLCN |ret| 






Base Offset 


Old 


New? 


000000 . . SLCN 


?????? 


010020 |ret| 


000000 . . SLCN+2 


?????? 


CTRUY 1 RET 1 


* 1 CTRL/C 1 




For SLX.SYS: 






.RUN SIPP |ret 






* SLX.SYS /A |ret| 






Base? |ret| 






Offset? . .SLCX |ret| 






Base Offset 


Old 


New? 


000000 . . SLCX 


?????? 


010020 |ret| 


000000 . . SLCX+2 


?????? 


CTRUY 1 RET 1 


* 1 CTRUC 1 





For SLMIN.SYS: 

.RUN SIPP [ret] 
*SLMIN.SYS/A [rIi] 
Base? I RET I 

Offset ? . . SLCM 
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Base 


Offset 


Old 


New? 


000000 


. . SLCM 


?????? 


010020 |RET| 


000000 


. . SLCM+2 


?????? 


CTRL/Y 1 1 RET 1 


1 CTRL/C 1 





2.6.70 Changing SL Character Edit Mode to REPLACE 

SL can edit single characters in two modes: INSERT mode and REPLACE mode. 
INSERT mode lets you place a character in the command line by shifting to the right 
all characters beyond that character. REPLACE mode lets you place a character 
in the command line without shifting any characters. SL is distributed in INSERT 
mode. You can alternate between INSERT and REPLACE mode by pressing CTRL/A. 
SL returns to INSERT mode at each command line. 

Apply the following customization to change the default mode for single-character 
editing from INSERT to REPLACE. You can still continue to alternate between 
REPLACE and INSERT mode by pressing CTRL/A. SL returns to REPLACE mode 
at each command line. 

Three patches are provided, one for each version of the SL command line editor. 
In the customization patches, _..IRDF, ..IRDX, and ..IRDM are the values for those 
symbols located in the file CUSTOM.TXT. 



For SL.SYS: 






.RUN SIPP |ret 






*SL.SYS/A |ret 






Base? |ret| 






Offset ? . . IRDF 1 RET 1 






Base Offset 


Old 


New? 


000000 . . IRDF 


?????? 


000000 |ret| 


000000 . . IRDF+2 


?????? 


CTRL/Y 1 1 RET 1 


* 1 CTRL/C 1 




For SLX.SYS: 






.RUN SIPP |ret 






*SLX.SYS/A |ret| 






Base? |ret| 






Offset? ..IRDX |ret| 






Base Offset 


Old 


New? 


000000 . . IRDX 


?????? 


000000 |ret| 


000000 . . IRDX+2 


?????? 


CTRL/Y 1 1 RET 1 


* 1 CTRL/C 1 





For SLMIN.SYS: 

.RUN SIPP [ret] 
*SLMIN.SYS/A [rIi] 
Base? I RET I 

Offset ? . . IRDM 
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Base 
000000 
000000 


Offset 
. .IRDM 
. . IRDM+2 


Old 
?????? 
?????? 


New? 

000000 |ret| 
ctrl/y 1 1 ret 1 


1 CTRL/C 1 





2.6.71 Changing the VTCOM Command Mode Character 

You can change the character you type to VTCOM to enter command mode. The 
default command mode character for VTCOM is |ctrl/p| . You can change the 
character CTRL/P to any you choose by using the following customization patch. 

In the customization, ..LCCH is the symbol for a value located in the file 
CUSTOM.TXT, nnn is the octal value for the new default command mode character. 
That new character cannot be printable and cannot be a character that RT-11 
intercepts and processes, such as Ictrl/fL |ctrl/bL |ctrl/xL Ictrl/oL and so on. 

For VTCOM.REL: 

.R SIPP [ret] 
*VTCOM.REL [rIi] 
Base? I RET I 

Offset ? . . LCCH [ret] 

New? 

New? 

nnn |ret 

CTRL/Y I RET I 



Base Offset Old 

000000 . .LCCH ?????? 

Base Offset Old 

000000 . .LCCH ??? 

000000 . .LCCH+1 ??? 



* 1 CTRL/C 1 










For VTCOM. SAV: 








.R SIPP 


|ret| 








*VTCOM.SAV |ret| 








Segment ? 


1 1 RET 1 








Base? 


1 RET 1 








Offset ? 


. . LCCH 


ret| 






Segment 


Base 




Offset 


Old 


000001 


000000 


. . LCCH 


?????? 


Segment 


Base 




Offset 


Old 


000001 


000000 


. . LCCH 


??? 


000001 


000000 


. . LCCH+1 


??? 


* 1 CTRL/C 1 











New? 

\ [m] 

New? 

nnn |ret| 

I CTRL/Y I I ret I 



2.6.72 Forcing Obsolete SJ Monitor Value in CONFIG Bit $FBMON 

Previously, a handler or program could check the state of the $FBMON bit in the 
CONFIG word (bit in RMON fixed offset 300) to determine under which monitor it 
was running. In particular, $FBMON being clear indicated the SJ monitor. Further, 
some programs may have used the state of $FBMON to determine other monitor 
characteristics. The removal of the SJ monitor and the advent of new monitors 
have decoupled those characteristics with any particular distributed monitor, and 
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$FBMON is set with all distributed monitors. All distributed RT-11 software is also 
decoupled from $FBMON. 

This customization patch is provided because a user-written device handler or 
program might require $FBMON be clear as a condition for installation. In that 
case, the following procedure is recommended: 

1. Perform the customization patch, which clears $FBMON in the file image, 
allowing the device handler to install once the customized monitor is booted. 

2. Reset $FBMON early in your start-up command file, using the command SET 
MODE NOSJ. 

The SET command conditions SET MODE SJ and SET MODE NOSJ clear or 
set bit zero (the $FBMON bit) in CONFIG. Those SET commands affect only 
the memory resident monitor image. Therefore, $FBMON is clear at installation 
time but correctly set before the system is used. 

Digital recommends you do not run RT-11 with $FBMON clear as that setting does 
not accurately describe any monitor distributed with the operating system. 

In the customization, monitr.sys is the monitor you are running, and CONFIG is the 
address of that symbol in the monitor link map. 

To clear $FBMON and thereby simulate the obsolete SJ monitor setting, clear the 
low bit in CONFIG. To set $FBMON (the distributed condition), set the low bit in 
CONFIG. 

.RUN SIPP [ret] 
*monitr . SYS |ret| 
Base? I RET I 

Offset? CONFIG [rIi] 



Base 


Offset 


Old 


New? 


000000 


CONFIG 


?????? 


\ |Ret| 


Base 


Offset 


Old 


New? 


000000 


CONFIG 


??? 


value with bit zero 




CONFIG+1 


??? 


set or clear |ret 


000000 


1 CTRLA' 1 1 RET | 


* 1 CTRL/C 1 









2.6.73 Making LINK /G Option a Default 

The LINK /G option (increasing the directory buffer size) is available only from CSI 
command syntax; it is not available as a DCL option. The following customization 
patch enables the /G option whenever LINK is run by any command syntax. You 
should read the LINK /G option section in the RT-11 System Utilities Manual before 
performing this patch as there are possible negative effects. 

In the customization, ..GON is the symbol for a value located in the file 
CUSTOM.TXT. 
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.RUN SIPP 
*LINK.SAV [ret] 
Segment ? 1 |ret| 
Base? I RET I 

Offset ? . . GON 



Segment 


Base 


Offset 


Old 


000001 


000000 


. .GON 


?????? 


000001 


000000 


. . GON+2 


?????? 


000000 


000000 


. . GON+4 


?????? 


* 1 CTRL/C 1 









New? 

240 [rIi] 
240 [ret] 

i ctrl/y i i ret i 



2.6.74 Changing the Default Magtape Label Size 

You can change the default magtape label size from 40 lo words to any value between 
40io and 512io- (The value is entered in the customization in octal radix.) 

In the following customization, ..MTLS is the symbol for the value located in 
CUSTOM.TXT, and nnnn is the octal value for the default magtape label size you 
want. 



.R SIPP 
*DUP . SAV 
Segment ? 
Base? 
Offset ? 


|Ret| 
|Ret| 

7 |ret| 

|ret| 
. .MTLS |REt| 


Segment 

000007 

000001 


Base ( 
000000 
000000 


* 1 CTRUC 1 





Offset Old 

. .MTLS ??? 

. .MTLS+2 ??? 



New? 
nnnn |ret| 

I CTRL/Y I I RET 
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Chapter 3 

Installing a System Distributed on RX01 to Run on 
RX01 

If RT-ll was distributed to you on single-density diskettes, and you intend to build 
a system to run on single-density diskettes, perform the procedures described in this 
chapter. 

NOTE 

If your hardware configuration includes a VTIOO 
terminal, be sure to set AUTO XON/XOFF in SETUP 
mode B before attempting to bootstrap RT-ll. Do not 
set TT NOPAGE when you use this terminal. Refer 
to your hardware manuals for more information about 
these settings. 

To install your system, perform the steps in the following list. Sections 3.1 through 
3.8 describe the procedures for each step. 

1. Bootstrap the distribution volume. 

2. Create the working system from chosen components. 

3. Install the bootstrap on volumes that need to be bootable. 

4. Customize the system. 

5. Compress each volume. 

6. Preserve the working system. 

7. Test the working system. 

8. If appropriate, perform the system generation process. 

9. Read the Introduction to RT-ll for more information on using RT-ll. 

The following sections correspond to each of these steps and describe in detail the 
procedures you must perform to complete each step. 

3.1 Bootstrapping the Distribution Volume 

The first procedure you perform when installing RT-ll is to bootstrap the 
distribution volume. 

Begin by making sure that the processor is powered up but not running. Insert 
distribution volume 1 in RXOl Unit 0. The device name for the RXOl drive is DX, 
so unit is DXO. 
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Use the hardware bootstrap to boot the volume. (If your configuration does not 
include a hardware bootstrap, see Appendix B for toggle-in software bootstraps.) 

RT-11 should respond with the following message if you have successfully 
bootstrapped the volume: 

RT-llFB V05.XX 
.TYPE V5USER.TXT 

RT-11 V5.XX 
Installation of RT-11 .... (followed by V5USER. TXT message) .... 



After you boot the system, you can edit the start-up file to turn on or enter any 
commands or sequence of commands that you would normally want to execute 
when you boot your processor. Editing start-up command files is described in the 
Introduction to RT-11. 

Next, remove the protection from all the files on the distribution diskettes. The files 
on the distribution diskettes have been protected to prevent you from accidentally 
deleting them. (Refer to the RT-11 Commands Manual for a description of file 
protection.) (Note the P that prints next to the file size in the directory.) For the rest 
of these procedures, you need to remove the protection from these diskettes. Type 
the following command to remove it from the files on distribution diskette 1: 

. UNPROTECT/ SYSTEM * . * [ret] 
Files unprotected: 
DK -.aaaaaa.ttt 
DK-.bbbbbb.ttt 
DK : cccccc .ttt 
DK-.dddddd.ttt 



DK: zzzzzz . ttt 



Insert distribution diskette 2 in Unit 1 and type the following command: 

. UNPROTECT /SYSTEM DXl :*.* [rIt] 
Files unprotected: 
DYl : aaaaaa . ttt 
DYl:bbbbbb.ttt 
DYl : cccccc . ttt 
DYl:dddddd.ttt 



DYl : zzzzzz. ttt 

Replace distribution diskette 2 with distribution diskette 3 in Unit 1 and repeat 
this command. In the same way, remove protection from the files on the remaining 
distribution diskettes. 
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3.2 Creating the Working System from Chosen Components 

Once you have chosen your system components (Section 2.4) and have planned the 
best arrangement of them on volumes (Section 2.5), you can create the working 
system by copying selected components to initialized, blank volumes. 

Start by initializing a number of blank volumes. Insert a write-enabled, blank 
volume in Unit 1 (with the system booted from Unit 0), and type INITIALIZE 
/BADBLOCKS DXl:. Repeat the process to create as many initialized blank volumes 
as you need for the system that you have planned. 

Then, use the COPY command to copy selected files from backup volume 1 to the 
volume that becomes your working system volume. The /SYSTEM option is required 
for copying .SYS files only if wildcards are used in the input file specification. 

.COPY DXO:filnam.typ DXl : filnam.typ \^ 

You can use the following command to avoid typing numerous file specifications. 

. COPY/QUERY/SYSTEM DXO : DXl : [rIt] 

Files copied: 
DXO : aaaaaa . ttt to DXl :aaaaaa.ttt? Y |ret| (includes aaaaaa.ttt) 
DXO-.bbbbbb.ttt to DXl:bbbbbb.ttt? N \^ (excludes bbbbbb.ttt) 

(and so on) 

To copy files from nonbootable volumes, alternate volumes. 
Use the SET command to set the USR to NOSWAP. 

.SET USR NOSWAP [ret] 

Type the following command, where filnam.typ is the name of the file you want to 
copy. In this case, you cannot use the /QUERY option; you must specify individual 
files. 

.COPY/WAIT DXl: filnam.typ DXO : filnam.typ [ret] 
Mount input volume in DXl:; Continue? 

Place the volume containing the file you want to copy in Unit 1. 

Y [ret] 

Mount output volume in DXO:; Continue? 

Replace the system volume in Unit with the volume to which you want to copy 
filnam.typ. 

Y [ret] 

Mount system volume in DXO:; Continue? 

Replace the volume in Unit with backup volume 1 (write-protected). 

Y [ret] 

Repeat this procedure to copy all the files for the working system volume. When you 
have copied all the files you have planned for the working system volume, label it 

Installing a System Distributed on RX01 to Run on RX01 3-3 



"RT-11 Working System V05 1". Repeat these procedures to create the other volumes 
in the working system. 

When you have created and labeled all the working system volumes, you can permit 
the USR to swap again. 

.SET USR SWAP [rIi] 



3.3 Installing the Bootstrap on Any Volumes That Need to Be 
Bootable 

Once you have created your system, install the bootstrap on any volumes that 
must be bootable (that is, that you can use as the system volume). Generally, any 
volume that includes a monitor file, SWAP.SYS, and system device handler should 
be bootable. 

Insert in Unit 1 the volume on which you need to install the bootstrap. In the 
following command, aa is SB, FB, or one of the mapped monitors. 

.COPY/BOOT DXl-.RTllaa.SYS DXl : [Rfr] 

In this command, you need to identify the device on which the monitor that contains 
the bootstrap information resides, the name of that monitor file, and the device on 
which you need to install the bootstrap. This command copies bootstrap information 
from the monitor file to blocks and 2 through 5 of the same volume. 

Then, insert working system volume 1 in Unit and use the hardware bootstrap to 
boot your working system. 

RT-llaa V05.XX 
(Followed by any start-up file commands.) 

Store the updated backup volumes for future updating purposes. 

3.4 Customizing the System 

You may want to make customizations (described in Section 2.6) to the distributed 
RT-11 components. At this point, perform the procedures to implement any of these 
software customizations. Table 1-2 summarizes the available customizations and 
directs you to the section in Chapter 2 that describes a particular customization and 
the procedure for implementing it. 

NOTE 

Later, you can perform the system generation process to 
implement additional customizations. (See Section 3.8.) 
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3.5 Compressing Each Volume 

Digital recommends that you compress each working system volume to make its free 
space contiguous. Consolidating free space allows you to use space on the volume 
that would otherwise be too fragmented to be usable. 

Continue to run RT-11 from Unit and use the SQUEEZE command to compress 
free space. (The volume must be write enabled.) The squeeze operation does not 
move files with the .BAD file type. 

.SQUEEZE DXO: [ret] 

DXO: /Squeeze; Are you sure? Y |ret| 

There is a delay while the system compresses the volume. 

RT-llaa V05.XX 
(Followed by any start-up file commands.) 

The system automatically reboots when you compress a system volume. 

Then, insert the next (write-enabled) volume that you need to compress in Unit 1. 

.SQUEEZE DXl: [ret] 

DXl : /Squeeze; Are you sure? Y |ret| 

Replace the volume in Unit 1 with the next one you need to compress. Repeat this 
procedure for all the volumes you need to compress. 

NOTE 

When you compress a volume with system files (.SYS), 
PIP warns you to reboot. Do reboot as advised. 
When you compress a system volume, the system 
automatically reboots. 

3.6 Preserving the Working System 

Once you build a satisfactory working system. Digital recommends that you protect 
all the files in the working system and preserve the system on backup volumes. 

Use the following command to protect all the files on the system volume: 

. PROTECT/SYSTEM * . * [ret] 
Files protected: 
DK -.aaaaaa.ttt 
DK:bbbbbb.ttt 
DK : cccccc .ttt 
DK-.dddddd.ttt 



DK: zzzzzz . ttt 
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To protect files on other volumes in the working system, insert each volume in Unit 
1 and use the following command: 

. PROTECT/SYSTEM DXl :*.* [ret] 
Files protected: 
DXl : aaaaaa .ttt 
DXl-.bbbbbb.ttt 
DXl : cccccc .ttt 
DXl:dddddd.ttt 



DXl : zzzzzz . ttt 

Next, copy the working system to backup volumes. Insert a blank volume (write- 
enabled) in Unit 1 with RT-11 still booted from Unit 0. Use the INITIALIZE 
/BADBLOCKS command to initialize the blank volume. Then, repeat the process to 
initialize the appropriate number of volumes. 

Copy all the files in your working system. You can use the SQUEEZE/OUTPUT:DXn: 
command to copy any bootable volumes. Remember to use SQUEEZEAVAIT 
/OUTPUT:DXn: and change volumes to copy the volumes that are not bootable. 
Also, remember to copy the bootstrap to any volumes that need to be bootable. 

Write-protect the backup working system volumes and store them. To restore the 
working system, make copies of the backup working system volumes. 

3.7 Testing the Working System 

Once you have built and preserved the working system, you can execute the 
following demonstration to test that system. This demonstration does not serve 
as a comprehensive system exercise; however, because it uses several major system 
components, it does serve as a minimal integrity check. Moreover, Digital considers 
your system officially installed if the demonstration runs without error. 

To execute this demonstration, your working system must include at least the 
following components: 

SWAP.SYS 

RTllFB.SYS (monitor) 

DX.SYS (system device handler) 

LP.SYS (or LS.SYS) 

KED.SAV 

MACRO.SAV 

SYSMAC.SML 

LINK.SAV 

PIPSAV 

DUPSAV 

DIR.SAV 

DEMOBG.MAC 

DEMOFG.MAC 
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Display the directory of the system volume on the terminal. The directory varies 
according to your working system. As long as a directory prints, you need not worry 
if it does not match the one in the following example. 

.DIRECTORY/BRIEF/COLUMNS : 1 SY: [retI 

dd-nmim-yy 
SWAP . SYS 
RTllFB.SYS 
LP . SYS 

DX . SYS 

RED . SAV 

MACRO .SAV 
SYSMAC.SML 
LINK . SAV 
PIP . SAV 



XXX Files, bbb Blocks 
fff Free blocks 



NOTE 

If you have shifted output to your terminal and the 
directory scrolls by too quickly to read, press |ctrus| 
or I HOLD screen] to stop the display and |ctruq| or 
I HOLD screen] again to restart it. 

Before you can execute the background and foreground demonstration programs, 
you must first edit, assemble, and link the background program, DEMOBG.MAC, 
and you must assemble and link the foreground program, DEMOFG.MAC. 

3.7.1 Preparing the Background Demonstration Program 
3.7.1.1 Edit the Background Demonstration Program 

Use the KED text editor to modify the background demonstration program, 
DEMOBG.MAC. One of the output lines in the program is preceded by a semicolon, 
which makes the line a comment field. The semicolon prevents the line from 
being printed; thus, it must be deleted from that line. If DEMOBG.MAC 
is a protected file, you must remove the protection before making the edits 
(UNPROTECT SY:DEMOBG.MAC). The following commands and keypad strokes 
open DEMOBG.MAC for editing and remove the semicolon from the file: 



.EDIT SY -.DEMOBG.MAC 

1 PF1 1 1 PF3 1 


|ret| 


Model? ; ItabI .ASCII 


1 4 1 


1 PF1 1 1 7 1 




Command? EXIT | enter | 
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3.7.1.2 Assemble the Background Demonstration Program 

The background program, DEMOBG.MAC, is an assembly language source file; it 
must be assembled and linked before you can execute it. To assemble DEMOBG.MAC 
and obtain a printed listing, first make sure that your configuration has an on-line 
printer that is ready and issue the following commands: 

.ASSIGN LS LP [ret] 
.ASSIGN LP LST [Rfr] 

If your configuration does not include a printer, use the console terminal: 

.ASSIGN TT LST [Rfr] 

Next, assemble DEMOBG.MAC as follows: 

.MACRO/LIST: LST: DEMOBG \^ 

(See Figure 3-1.) 

If any errors occur when you assemble DEMOBG.MAC, you have incorrectly edited 
the file and should repeat the edits. Use the backup demonstration program. 

.RENAME SY: DEMOBG. BAK SY : DEMOBG . MAC \^] 

Then, repeat the editing procedure. 

3.7.1.3 Link thie Background Demonstration Program 

Link the program DEMOBG. OBJ to produce an executable background program, 
DEMOBG.SAV. 

.LINK DEMOBG [Rfr] 

3.7.1.4 Run thie Background Demonstration Program 

Run the program DEMOBG to check the results of the first exercise. 

.RUN DEMOBG \^] 
RT-11 DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED, THIS IS THE LAST LINE. 
WELL DONE. 

If you did not delete the semicolon character, the last line will not print. Return to 
the monitor by twice pressing CTRL/C: 



I CTRL/C I 
I CTRL/C I 



If you incorrectly edited the file, you can repeat this exercise, although you can 
continue without correcting the file. However, if you want to repeat the exercise, 
begin by using the backup demonstration program. 

.RENAME SY : DEMOBG . BAK SY : DEMOBG . MAC [bH] 
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Figure 3-1 : DEMOBG Assembly Listing 

DEMOBG MACRO V05.0S Sunday 13-Jan-91 13:33 Page 1 

1 . TITLE DEMOBG 

2 .IDENT /V05.00/ 

3 ; DEMONSTRATION PROGRAM TO PRINT DEMONSTRATION MESSAGE, THEN 

4 ; RING BELL IF FG JOB SENDS A MESSAGE. 
5 

6 .MCALL .RCVDC, .PRINT 

7 

8 000000 START:: .RCVDC iAREA, iBUFFER, #400, #MSGIN ;POST REQUEST FOR MESSAGE 

9 000034 .PRINT #MSG ; PRINT DEMONSTRATION MESSAGE 
10 000042 000777 BR ; AND LOOP 

11 

12 ; COMPLETION ROUTINE ENTERED WHEN FG SENDS MESSAGE 

13 

14 000044 MSGIN: .PRINT iBELL ;RING BELL IN RESPONSE TO MESSAGE 

15 000052 .RCVDC #AREA, iBUFFER, #400, #MSGIN ; POST ANOTHER MESSAGE REQUEST 

16 000106 000207 RETURN ;AND RETURN FROM COMPLETION ROUTINE 
17 

18 ; ASCII MESSAGES 

19 .NLIST BEX 

20 000110 007 BELL: .BYTE 7,200 ;MESSAGE THAT RINGS BELL 
21 

22 000112 122 MSG: .ASCII /RT-11 DEMONSTRATION PROGRAM/<lS><12> 

23 000147 111 .ASCII /IF INCORRECTLY EDITED, THIS IS THE LAST LINE. /<1S><12> 

24 000225 127 .ASCII /WELL DONE./ 

25 000237 000 .BYTE 
26 

27 000240 AREA: .BLKW 6 ;EMT ARGUMENT AREA 

28 000254 BUFFER: ;RCVDC MESSAGE AREA 

29 000000' .END START 
DEMOBG MACRO V05 . 05 Sunday 13-Jan-91 13:33 Page 1-1 
Symbol table 

AREA 000240R MSG 000112R ...VI = 000003 

BELL OOOllOR MSGIN 000044R . . .V2 = 000027 

BUFFER 000254R START OOOOOORG 

. ABS. 000000 000 (RW, I,GBL,ABS,OVR) 

000254 001 (RW,I,LCL,REL,CON) 

Errors detected: 

*** Assembler statistics 

Work file reads: 

Work file writes: 

Size of work file: 10912 Words ( 43 Pages) 

Size of core pool: 21760 Words ( 85 Pages) 

Operating system: RT-11 

Elapsed time: 00:00:06.16 
DEMOBG, DEMOBG/L : TTM=DEMOBG 

3.7.2 Preparing the Foreground Demonstration Program 

DEMOFG.MAC is a small foreground program that sends a message every 2 seconds 
to DEMOBG (running in the background), telling it to ring the terminal bell. 
DEMOBG recognizes these messages and rings the bell once for each message sent. 

Although DEMOFG is always active, sending messages to the background every 2 
seconds, the circuit is complete and messages are successfully received and honored 
only when DEMOBG is active. During those periods when DEMOBG is not running, 
DEMOFG enters the messages in the monitor message queue. Once you restart 
DEMOBG in the background, the system immediately releases all the messages 
queued since the last forced exit, resulting in many successive bell rings. When the 
queue is empty, the normal send/receive cycle resumes and the bell rings every 2 
seconds as each current message is sent and honored. 
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To execute the foreground program, assemble the program DEMOFG.MAC, link it 
for the foreground, and execute it in conjunction with DEMOBG.SAV. 

3.7.2.1 Assemble the Foreground Demonstration Program 

The foreground demonstration program, DEMOFG.MAC, is an assembly language 
source file; it must be assembled and linked before you can use it. Assemble 
DEMOFG.MAC as follows: 

. MACRO/LIST :LST: DEMOFG \^ 

The output resulting from this MACRO command is an object file called 
DEMOFG.OBJ. This file resides on your system volume. 

3.7.2.2 Link thie Foreground Demonstration Program 

You must link the DEMOFG.OBJ file to produce an executable program. Use the 
/FOREGROUND option to produce the load module DEMOFG.REL. The .REL file 
type signifies to the system that the file is a foreground program and is to be run as 
the priority job. 

.LINK/FOREGROUND DEMOFG \^ 

3.7.2.3 Run thie Foreground and Bacl<ground Demonstration Programs 

Type the following command to load and start DEMOFG.REL as the foreground job. 

.FRUN DEMOFG [rIt] 

F> 

FOREGROUND DEMONSTRATION PROGRAM 

SENDS A MESSAGE TO THE BACKGROUND PROGRAM DEMOBG 

EVERY 2 SECONDS, TELLING IT TO RING THE BELL. 



B> 

DEMOFG.REL is now running and queuing the message for DEMOBG every 2 
seconds. Now execute DEMOBG.SAV in the background and receive the messages. 

.RUN DEMOBG [Rfr] 

(The bell rings quickly several times, then once every 2 seconds.) 

RT-11 DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED, THIS IS THE LAST LINE. 

WELL DONE. 

Execute a DIRECTORY command in the background to obtain a directory listing. 



(The bell stops ringing. ) 
.DIRECTORY [ret] 
dd-mmm-yy 
(The directory of the device DK prints on the terminal . ) 
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Rerun DEMOBG to collect all the foreground messages queued while the directory 
was printing. 

.RUN DEMOBG [ret] 

(The bell rings several times in rapid succession, then rings once every 2 seconds.) 

RT-11 DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED, THIS IS THE LAST LINE. 

WELL DONE. 



CTRL/C 



(The bell stops ringing. ) 
Now, stop the foreground program and remove it from memory. 



CTRL/F 



F> 



I CTRL/C I 
I CTRL/C I 



B> 

UNLOAD F [rHI 

If you completed these exercises without error, your system has passed this minimal 
test and you can consider it successfully installed. 

3.8 Performing the System Generation Process 

If you need RT-11 features that are available only if you generate your own 
monitor(s) and handlers, perform the system generation on a computer system 
containing more suitable storage media and then use the generated modules on 
your RXOl system. 

3.9 Further Information 

After installing RT-11, read the Introduction to RT-11. The Introduction to RT-11 
provides a tutorial interactive explanation of RT-11. 
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Chapter 4 

Installing a System Distributed on RX01 to Run on a 
Hard Disk 

If your distribution media is single-density diskettes, and you intend to build a 
system to run on hard disk, perform the procedures described in this chapter. These 
procedures cover minor variations that depend on the specific device you have and 
assume that your configuration includes two hard disk drives. 

NOTE 

If your hardware configuration includes a VTIOO 
terminal, be sure to set AUTO XON/XOFF in SETUP 
mode B before attempting to bootstrap RT-11. Do not 
set TT NOPAGE when you use this terminal. Refer 
to your hardware manuals for more information about 
these settings. 

To install your system, perform the steps in the following list. Sections 4.1 through 
4.10 describe the procedures for each step. 

1. Bootstrap the distribution volume. 

2. Copy the distribution volumes to the disk. 

3. Preserve the distribution volumes. 

4. Create the working system from chosen components. 

5. Install the bootstrap on the disk. 

6. Customize the system. 

7. Compress the disk. 

8. Preserve the working system. 

9. Test the working system. 

10. If appropriate, perform the system generation process. 

11. Read the Introduction to RT-11 for more information on using RT-11. 

4.1 Bootstrapping the Distribution Volume 

The first procedure you perform when installing RT-11 is to bootstrap the 
distribution volume. 



Installing a System Distributed on RX01 to Run on a Hard Disk 4-1 



Begin by making sure that the processor is powered up but not running. Insert the 
distribution volume labeled 1 (write-protected) in RXOl diskette Unit 0. For RXOl 
diskette, the device name is DX:. 

Use the hardware bootstrap to boot the volume. (If your configuration does not 
include a hardware bootstrap, see Appendix B for toggle-in software bootstraps.) 

RT-11 should respond with the following message if you have successfully 
bootstrapped the volume: 

RT-llFB V05.XX 
.TYPE V5USER.TXT 
RT-11 V5.XX 
Installation of RT-11 .... (followed by V5USER. TXT message) .... 

After you boot the system, you can create a start-up file containing any commands 
or sequence of commands that you would normally want to execute at the start of 
each terminal session. 

You can update your start-up file at any time to change, add, or delete commands. 
When you first create the file, or after you update it, you can execute it with the @ 
command, so that the commands it contains become effective. See the Introduction 
to RT-11 for information on start-up command files. 

4.2 Copying the Distribution Volumes to the Disk 

With the RT-11 system running, copy all the distribution volumes to the disk that 
will serve as your working system disk. 

If the disk is an RK05 disk, mount the disk in Unit 0, format the disk, and then 
initialize it and cover any bad blocks on it. 

If the disk is another type, initialize the disk and replace or cover any bad blocks. 
You have a choice of replacing or covering bad blocks if your disk is MSCP or is an 
RK06, RK07, RLOl, or RL02. If your disk is another type, you should cover any bad 
blocks. 

To replace bad blocks, use the INITIALIZE/REPLACE command, and to cover bad 
blocks, use the INITIALIZE/BADBLOCKS command (procedures follow). In the 
commands, xx is the permanent device name for your disk. If the disk contains bad 
blocks, the ?DUP-W-Bad blocks detected nnnnnn message appears on the terminal, 
but you can use the disk. 

RL02 disk 

.FORMAT DLO: [rIt] 

DLO : /FORMAT-Are you sure? Y |ret| 

?FORMAT-I-Fonnatting complete 

.INITIALIZE/BADBLOCKS DLO: [ret] 

DLO : /Initialize; Are you sure? Y |ret| 

?DUP-I-No bad blocks detected DLO: 
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Other type disk 

. INITIALIZE/BADBLOCKS xxO : 

xxO : /Initialize; Are you sure? Y |ret| 

?DUP-I-No bad blocks detected xxO: 

or 

.INITIALIZE/REPLACE xxO : [ret] 

xxO : /Initialize; Are you sure? Y |ret| 

7DUP-I-NO bad blocks detected xxO: 

There is a delay as the system scans the disk for bad blocks and creates a new 
directory. The monitor dot appears when this process is complete. 



The next step in the preservation process is to copy all the files from distribution 
volume 1 to the initialized disk. The following command transfers files from the 
distribution volume to the disk and consolidates all the empty space at the end of 
the disk. In the command, xx is the permanent device name for your disk. 

. SQUEEZE/OUTPUT : xxO : DXO : [ret] 

NOTE 

Both the SQUEEZE command with the /OUTPUT:xxn: 
option and the COPY command transfer files from 
one device to another. SQUEEZE/OUTPUT:xxn: 
consolidates free space on the device at the same time. 
The procedures in this manual use the command that is 
most appropriate and most efficient for an individual 
operation. For a better understanding of all RT- 
11 keyboard monitor commands, refer to the RT-11 
Commands Manual. 

There may be a delay while the system performs this operation. 

You must also copy the rest of the distribution volumes to the disk. Insert 
distribution volume 2 in RXOl Unit 1. In the following command, xx is the 
permanent device name for your disk, and yy is the name for your distribution 
device. The /SYSTEM option is required for copying .SYS files only if wildcards are 
used in the input file specification. 

. COPY/SYSTEM DXl : xxO : [ret] 
Files copied: 
DXl : aaaaaa . ttt to xxO : aaaaaa . ttt 
DXl:bbbbbb.ttt to xxO : bbbbbb . ttt 



DXl : zzzzzz .ttt to xxO : zzzzzz .ttt 

Insert distribution volume 3 in RXOl Unit 1 and repeat this command. Copy all the 
distribution volumes to your disk in this way. 
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NOTE 

For optimal system performance, copy the distribution 
volumes in numerical order. 

Finally, copy the bootstrap to the disk and compress the disk. Use the following 
commands, where xx is the permanent device name for your disk. 

.COPY /BOOT xxO-.RTllFB.SYS xxO : [retI 

.SQUEEZE xxO: |ret| 

xxO: /Squeeze; Are you sure? Y |ret| 



4.3 Preserving the Distribution Volumes 

Halt the processor and remove the distribution volumes. Then, store them as a safety 
measure in case of machine failure or human error. Use the disk to build a working 
system. Leave the write-enabled disk in Unit 0. Use the hardware bootstrap to boot 
RT-11 from your disk. 

RT-llFB V05.XX 
(Followed by any start-up file commands.) 



NOTE 

If the disk does not boot, repeat the procedures to this 
point. 

Next, remove the protection from all the files on the backup disk. The files on the 
distribution volumes have been protected to prevent you from accidentally deleting 
them. (Refer to the RT-11 Commands Manual for a description of file protection.) 
When you used the SQUEEZE command to copy the files to the backup disk, RT- 
11 also copied the protection. (Note the P that prints next to the file size in the 
directory.) For the rest of these procedures, remove the protection from the backup 
disk. Use the following command: 

. UNPROTECT/ SYSTEM * . * [ret] 
Files unprotected: 
DK -.aaaaaa.ttt 
DK-.bbbbbb.ttt 
DK : cccccc .ttt 
DK-.dddddd.ttt 



DK: zzzzzz . ttt 



4.4 Creating the Working System from Chosen Components 

Once you have chosen your system components (Section 2.3) and have planned the 
best arrangement of them on a disk (Section 2.4), you can create the working system 
by copying selected components to another disk or disks. 
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Mount a blank disk in disk Unit 1 and initialize it. (If the disk is an RK05 disk, 
format it before you initialize it.) 

RL02 disk 



. INITIALIZE/BADBLOCKS DLl : 

DLl : /Initialize; Are you sure? Y |ret| 

7DUP-I-NO bad blocks detected DLl: 

Other type disk 

.INITIALIZE/BADBLOCKS xxl : [ret] 

xxl : /Initialize; Are you sure? Y |ret| 

7DUP-I-NO bad blocks detected xxl : 

or 

.INITIALIZE/REPLACE xxl: [ret] 

xxl : /Initialize; Are you sure? Y |ret| 

7DUP-I-NO bad blocks detected xxl : 

Copy the files you have selected from the disk in Unit to the disk in Unit 1, which 
will become your working system disk. If you use the following command, RT-11 
queries you about all the files on the disk in Unit 0, and you can choose the files it 
copies. 



.COPY/SYSTEM/QUERY xxO : xxl: 

Files copied: 
xxO : aaaaaa . ttt to xxl :aaaaaa.ttt? Y |ret| (includes aaaaaa.ttt) 
xxO:bbbbbb.ttt to xxl :bbbbbb.ttt? N \^ (excludes bbbbbb.ttt) 
(and so on) 

4.5 Installing the Bootstrap on the Disk 

Once you have created your system, install the bootstrap on the system disk. In the 
following command, aa is SB, FB, or one of the mapped monitors. 

.COPY/BOOT xxl:RTllaa.SYS xxl: [Rfr] 

In this command, you identify the device on which the monitor that contains the 
bootstrap information resides (your disk), the name of that monitor file, and the 
device on which you need to install the bootstrap (your disk). This command copies 
bootstrap information from the monitor file to blocks and 2 through 5 of the same 
disk. 

Remove the disk from Unit and store it for future updates. Mount the new working 
system disk in Unit 0, and use the hardware bootstrap to boot the working system 
disk. 

RT-llaa V05.XX 
(Followed by any start-up file commands.) 
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4.6 Customizing the System 

You may want to make customizations (described in Section 2.6) to the distributed 
RT-11 components. At this point, perform the procedures to implement any of these 
software customizations. Table 1-2 summarizes the available customizations and 
directs you to the section in Chapter 2 that describes a particular customization and 
the procedure for implementing it. 

NOTE 

Later, you can perform the system generation process to 
implement additional customizations. (See Section 4.10.) 

4.7 Compressing the Disk 

Digital recommends that you compress the working system disk to make its free 
space contiguous. Consolidating free space allows you to use space on the disk that 
would otherwise be too fragmented to be usable. 

Use the SQUEEZE command to compress free space. (The volume must be write 
enabled.) The squeeze operation does not move files with the .BAD file type. 

. SQUEEZE xxO : |ret| 

xxO: /Squeeze; Are you sure? Y |ret| 
RT-llaa V05.XX 
(Followed by any start-up file commands.) 

The system automatically reboots when you compress a system disk. 

4.8 Preserving the Working System 

Once you build a satisfactory working system. Digital recommends that you protect 
all the files in the working system and back it up. 

Use the following command to protect all the files on the system disk: 

. PROTECT/SYSTEM * . * [ret] 
Files protected: 
DK :aaaaaa.ttt 
DK:bbbbbb.ttt 
DK : cccccc .ttt 
DK:dddddd.ttt 



DK: zzzzzz . ttt 



Now, preserve the working system on the backup medium of your choice. 
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4.8.1 Backing Up the System on RX01 Diskettes 

Insert a blank RXOl diskette in Unit 1 (with RT-11 still booted from disk Unit 0). 
Use the INITIALIZE/BADBLOCKS command to initialize the blank diskette. Then, 
repeat the process to initialize the appropriate number of diskettes. 

Copy all the files in your working system, using the COPY/MULTIVOLUME 
command. In the command, yy is the name for your disk. The system copies all 
the files from the input volume that will fit on the output volume. When no more 
files will fit on the output volume, the system prompts you to mount the next output 
volume and prints the Continue? message. 

Mount another blank, initialized diskette, and type Y to continue. Continue to mount 
diskettes in this fashion until all the files are copied. 

. COPY/MULTIVOLUME /SYSTEM yyO : DXl : [ret] 

Files copied: 
yyO : aaaaaa . ttt to DXl : aaaaaa . ttt 
yyO:bbbbbb.ttt to DXl : bbbbbb . ttt 

(and so on) 

Mount next output volume in DXl:; Continue? y |RET| 

(Log of files copied) 
Mount next output volume in DXl:; Continue? Y |ret| 

(Log of files copied) 
Mount next output volume in DXl:; Continue? Y |ret| 

(Log of files copied) 
Mount next output volume in DXl:; Continue? Y |ret| 

(Log of files copied) 
Mount next output volume in DXl:; Continue? Y |ret| 



If not enough space exists on the diskette to contain all the files, remove the diskette 
when it is full, insert a blank, initialized diskette in the drive, and issue the COPY 
command again. Answer N to all files that have already been copied to a backup 
diskette. 

Store the backup diskettes. To restore the working system, you can copy the backup 
diskettes to the disk. 

4.8.2 Backing Up the System on Another Disk 

To back up your system on another disk, initialize a blank disk and copy all the files 
from the working system disk to the backup disk. In the following commands, xx is 
the permanent device name for your disk. 

RL02 disk 



. INITIALIZE/BADBLOCKS DLl : 

DLl : /Initialize; Are you sure? Y |ret| 

?DUP-I-No bad blocks detected RKl: 
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Other type disk 

. INITIALIZE/BADBLOCKS xxl : 

xxl : /Initialize; Are you sure? Y |ret| 

?DUP-I-No bad blocks detected xxl : 



or 

.INITIALIZE/REPLACE xxl: [ret] 

xxl : /Initialize; Are you sure? Y |ret| 

7DUP-I-NO bad blocks detected xxl : 



Copy all the files in your working system. 
. SQUEEZE/OUTPUT : xxl : xxO : 



Copy the bootstrap to the backup working system disk. In the following command, 
aa is SB, FB, or one of the mapped monitors. 

.COPY/BOOT xxl:RTllaa.SYS xxl: [Rfr] 

Store the backup working system disk. If you ever need to restore the working 
system, you can make a copy of the backup working system disk. 

4.9 Testing the Working System 

Once you have built and preserved the working system, you can execute the 
following demonstration to test that system. This demonstration does not serve 
as a comprehensive system exercise; however, because it uses several major system 
components, it does serve as a minimal integrity check. Moreover, Digital considers 
your system officially installed if the demonstration runs without error. 

To execute this demonstration, your working system must include at least the 
following components: 

SWAP.SYS 

RTllFB.SYS 

XX. SYS (system device handler) 

LP.SYS (or LS.SYS) 

KED.SAV 

MACRO.SAV 

SYSMAC.SML 

LINK.SAV 

PIP.SAV 

DUP.SAV 

DIR.SAV 

DEMOBG.MAC 

DEMOFG.MAC 
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Display the directory of the system volume on the terminal. The directory varies 
according to your particular working system. As long as a directory prints, you need 
not worry if it does not match the one in the following example. 

.DIRECTORY/BRIEF/COLUMNS : 1 SY: [retI 

dd-nmim-yy 
SWAP . SYS 
RTllFB.SYS 
LP . SYS 

DX . SYS 

RED . SAV 

MACRO .SAV 
SYSMAC.SML 
LINK . SAV 
PIP . SAV 



XXX Files, bbb Blocks 
fff Free blocks 



NOTE 

If you have shifted output to your terminal and the 
directory scrolls by too quickly to read, press |ctrus| 
or I HOLD screen] to stop the display and |ctruq| or 
I HOLD screen] again to restart it. 

Before you can execute the background and foreground demonstration programs, 
you must first edit, assemble, and link the background program, DEMOBG.MAC, 
and you must assemble and link the foreground program, DEMOFG.MAC. 

4.9.1 Preparing the Background Demonstration Program 
4.9.1.1 Edit the Background Demonstration Program 

Use the KED text editor to modify the background demonstration program, 
DEMOBG.MAC. One of the output lines in the program is preceded by a semicolon, 
which makes the line a comment field. The semicolon prevents the line from 
being printed; thus, it must be deleted from that line. If DEMOBG.MAC 
is a protected file, you must remove the protection before making the edits 
(UNPROTECT SY:DEMOBG.MAC). The following commands and keypad strokes 
open DEMOBG.MAC for editing and remove the semicolon from the file: 



.EDIT SY -.DEMOBG.MAC 

1 PF1 1 1 PF3 1 


|ret| 


Model? ; ItabI .ASCII 


1 4 1 


1 PF1 1 1 7 1 




Command? EXIT | enter | 
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4.9.1.2 Assemble the Background Demonstration Program 

The background program, DEMOBG.MAC, is an assembly language source file; it 
must be assembled and linked before you can execute it. To assemble DEMOBG.MAC 
and obtain a printed listing, first make sure that your configuration has an on-line 
printer that is ready and issue the following commands: 

.ASSIGN LS LP [ret] 
.ASSIGN LP LST [Rfr] 

If your configuration does not include a printer, use the console terminal: 

.ASSIGN TT LST [Rfr] 

Next, assemble DEMOBG.MAC as follows: 

.MACRO/LIST: LST: DEMOBG \^ 

(See Figure 4-1.) 

If any errors occur when you assemble DEMOBG.MAC, you have incorrectly edited 
the file and should repeat the edits. Use the backup demonstration program. 

.RENAME SY: DEMOBG. BAK SY : DEMOBG . MAC \^] 
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Figure 4-1 : DEMOBG Assembly Listing 
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1 
2 
3 
4 
5 
6 
7 

8 000000 

9 000034 

10 000042 000777 

11 

12 

13 

14 000044 

15 000052 

16 000106 000207 
17 

18 

19 

20 000110 

21 

22 000112 

23 000147 

24 000225 

25 000237 
26 

27 000240 

28 000254 

29 OOOOi 
DEMOBG MACRO V05 . 05 
Symbol table 



. TITLE DEMOBG 

.IDENT /V05.00/ 
; DEMONSTRATION PROGRAM TO PRINT DEMONSTRATION MESSAGE, THEN 
; RING BELL IF FG JOB SENDS A MESSAGE. 

.MCALL .RCVDC, .PRINT 

START:: .RCVDC iAREA, #BUFFER, #400, #MSGIN ;POST REQUEST FOR MESSAGE 
.PRINT #MSG ; PRINT DEMONSTRATION MESSAGE 

BR ;AND LOOP 

; COMPLETION ROUTINE ENTERED WHEN FG SENDS MESSAGE 

MSGIN: .PRINT iBELL ;RING BELL IN RESPONSE TO MESSAGE 

.RCVDC #AREA,#BUFFER,#400,#MSGIN ; POST ANOTHER MESSAGE REQUEST 
RETURN ;AND RETURN FROM COMPLETION ROUTINE 



007 BELL: 

122 MSG: 

111 

127 

000 

AREA: 
BUFFER: 



ASCII MESSAGES 
.NLIST BEX 
.BYTE 7,200 



; MESSAGE THAT RINGS BELL 



.ASCII /RT-11 DEMONSTRATION PROGRAM/<lS><12> 

.ASCII /IF INCORRECTLY EDITED, THIS IS THE LAST LINE. /<1S><12> 

.ASCII /WELL DONE./ 

. BYTE 

.BLKW 6 ;EMT ARGUMENT AREA 

; RCVDC MESSAGE AREA 
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AREA 000240R 

BELL OOOllOR 

BUFFER 000254R 

. ABS. 000000 
000254 
Errors detected: 



000 
001 




MSG 000112R 

MSGIN 000044R 
START OOOOOORG 

(RW, I, GBL, ABS, OVR) 
(RW, I, LCL, REL, CON) 



. .VI = 000003 
. .V2 = 000027 



*** Assembler statistics 



Work file reads: 
Work file writes: 
Size of work file: 
Size of core pool : 
Operating system: 







10912 Words 

21760 Words 

RT-11 



( 43 Pages) 
( 85 Pages) 



Elapsed time: 00:00:06.16 
DEMOBG, DEMOBG/L : TTM=DEMOBG 
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4.9.1.3 Link the Background Demonstration Program 

Link the program DEMOBG.OBJ to produce an executable background program, 
DEMOBG.SAV. 

.LINK DEMOBG [fll] 

4.9.1.4 Run the Background Demonstration Program 

Run the program DEMOBG to check the results of the first exercise. 

.RUN DEMOBG [Rfr] 

RT-11 DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED, THIS IS THE LAST LINE. 

WELL DONE. 

If you did not delete the semicolon character, the last line will not print. Return to 
the monitor by twice pressing CTRL/C: 



If you incorrectly edited the file, you can repeat this exercise, although you can 
continue without correcting the file. However, if you want to repeat the exercise, 
begin by using the backup demonstration program. 

.RENAME SY : DEMOBG . BAK SY : DEMOBG . MAC [ret] 

Then, repeat the editing procedure. 

4.9.2 Preparing the Foreground Demonstration Program 

DEMOFG.MAC is a small foreground program that sends a message every 2 seconds 
to DEMOBG (running in the background), telling it to ring the terminal bell. 
DEMOBG recognizes these messages and rings the bell once for each message sent. 

Although DEMOFG is always active, sending messages to the background every 2 
seconds, the circuit is complete and messages are successfully received and honored 
only when DEMOBG is active. During those periods when DEMOBG is not running, 
DEMOFG enters the messages in the monitor message queue. Once you restart 
DEMOBG in the background, the system immediately releases all the messages 
queued since the last forced exit, resulting in many successive bell rings. When the 
queue is empty, the normal send/receive cycle resumes and the bell rings every 2 
seconds as each current message is sent and honored. 

To execute the foreground program, assemble the program DEMOFG.MAC, link it 
for the foreground, and execute it in conjunction with DEMOBG.SAV. 

4.9.2.1 Assemble the Foreground Demonstration Program 

The foreground demonstration program, DEMOFG.MAC, is an assembly language 
source file; it must be assembled and linked before you can use it. Assemble 
DEMOFG.MAC as follows: 
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. MACRO/LIST :LST: DEMOFG [flT] 

The output resulting from this MACRO command is an object file called 
DEMOFG.OBJ. This file resides on your system volume. 

4.9.2.2 Link the Foreground Demonstration Program 

You must link the DEMOFG.OBJ file to produce an executable program. Use the 
/FOREGROUND option to produce the load module DEMOFG.REL. The .REL file 
type signifies to the system that the file is a foreground program and is to be run as 
the priority job. 

.LINK/FOREGROUND DEMOFG \^] 

4.9.2.3 Run thie Foreground and Bacl<ground Demonstration Programs 

Type the following command to load and start DEMOFG.REL as the foreground job. 

.FRUN DEMOFG [ret] 
F> 

FOREGROUND DEMONSTRATION PROGRAM 

SENDS A MESSAGE TO THE BACKGROUND PROGRAM DEMOBG 
EVERY 2 SECONDS, TELLING IT TO RING THE BELL. 

I CTRL/B I 



B> 

DEMOFG.REL is now running and queuing the message for DEMOBG every 2 
seconds. Now execute DEMOBG.SAV in the background and receive the messages. 

.RUN DEMOBG [rIi] 

(The bell rings quickly several times, then once every 2 seconds.) 

RT-11 DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED, THIS IS THE LAST LINE. 

WELL DONE. 

Execute a DIRECTORY command in the background to obtain a directory listing. 



I CTRL/C I 
I CTRL/C I 



(The bell stops ringing.) 

.DIRECTORY [ret] 
dd-mmm-yy 

(The directory of the device DK prints on the terminal.) 

Rerun DEMOBG to collect all the foreground messages queued while the directory 
was printing. 

.RUN DEMOBG [rH] 

(The bell rings several times in rapid succession, then rings once every 2 seconds.) 
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RT-11 DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED, THIS IS THE LAST LINE. 

WELL DONE. 



CTRL/C 



(The bell stops ringing.) 

Now, stop the foreground program and remove it from memory. 



F> 



I CTRL/C I 
I CTRL/C I 



B> 

UNLOAD F [rHI 

If you completed these exercises without error, your system has passed this minimal 
test and you can consider it successfully installed. 

4.10 Performing the System Generation Process 

If you have decided that you need RT-11 features that are available only if you 
generate your own monitor(s) and handlers, perform the system generation process 
at this point. You should have thoroughly studied Chapter 1 to make this decision 
and to establish that you can perform the system generation process on your 
hardware configuration. Read the RT-11 System Generation Guide for guidance 
in planning and performing system generation. 

4.11 Further Information 

After installing RT-11, read the Introduction to RT-11. The Introduction to RT-11 
provides a tutorial interactive explanation of RT-11. 
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Chapter 5 

Installing a System Distributed on RL02 to Run on 
Hard Disk 

If your distribution media is an RL02 hard disk and you intend to build a system to 
run on hard disk, perform the procedures described in this chapter. These procedures 
assume that your configuration includes two disk drives (not necessarily of the same 
type). 

NOTE 

If your hardware configuration includes a VTIOO 
terminal, be sure to set AUTO XON/XOFF in SETUP 
mode B before attempting to bootstrap RT-11. Do not 
set TT NOPAGE when you use this terminal. Refer 
to your hardware manuals for more information about 
these settings. 

To install your system, perform the steps in the following list. Sections 5.1 through 
5.9 describe the procedures for each step. 

1. Bootstrap the distribution disk. 

2. Preserve the distribution disk. 

3. Create the working system from chosen components. 

4. Install the bootstrap on the disk. 

5. Customize the system. 

6. Compress the disk. 

7. Preserve the working system. 

8. Test the working system. 

9. If appropriate, perform the system generation process. 

10. Read the Introduction to RT-11 for more information on using RT-11. 

5.1 Bootstrapping the Distribution Disk 

The first procedure you perform when installing RT-11 is bootstrapping the 
distribution disk. 

Begin by making sure that the processor is powered up but not running. Mount 
the distribution disk (write-protected) in disk Unit 0. The device name is DL. Use 
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the hardware bootstrap to boot the disk. (If your configuration does not include a 
hardware bootstrap, refer to Appendix B for the toggle-in software bootstrap.) 

RL02 disks are normally installed manually. If you successfully bootstrap an RL02 
disk, RT-11 responds with the following dialog and installation verification message. 
The dialog gives you the choice of installing RT-11 manually or by using the 
automatic installation procedure. 

Welcome to RT-11 Version 5. 

You have bootstrapped the RT-11 Distribution Disk. Use this disk to 
install your RT-11 system, then store it in a safe place. 

RT-11 V5 provides an automatic installation procedure which will 
back up your distribution disk and build a working system disk which 
should be used for your work with RT-11. This working system disk 
will only contain the RT-11 operating system. After the RT-11 
installation is complete, follow the installation instructions 
packaged with any optional languages or utility software which you 
will be using. 

Press the "RETURN" key when ready to continue. |ret| 

you can choose to install RT-11 manually . This procedure is 

described in the RT-11 Installation Guide. 

If you are a new user of RT-11, Digital highly recommends that you 
use the automatic installation procedure. 

Do you want to use the automatic installation procedure? 
(Type YES or NO and press the "RETURN" key) : NO [ret] 

The standard RT-11 monitor bootstrap (RTllFB) will now be 
copied to this disk and this system disk will be rebooted. 
Please refer to the RT-11 Installation Guide for assistance 
while manually installing RT-11 Version 5. 



Press the "RETURN" key when ready to continue . 

RT-llFB V05.XX 

.TYPE V5USER.TXT 

RT-11 V5.XX 

Installation of RT-11. . . . (followed by V5USER.TXT message) .... 

Now you can edit the start-up file to turn on or create any commands or sequence 
of commands that you would normally want to execute at the start of each terminal 
session. Editing start-up command files is described in the Introduction to RT-11. 

5.2 Preserving the Distribution Disk 

The first procedure you perform with the running RT-11 system is to copy the 
distribution disk for backup, as a safety measure in case of machine failure or 
human error. You can then use the backup copy of the distribution disk to build 
your working system. 

Mount a blank disk in the other disk drive, if necessary. If the disk is an RK05 disk, 
format it, initialize it, and cover any bad blocks on it. 
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If the disk is another type, initialize the disk and replace bad blocks (using 
the command INITIALIZE/REPLACE) or cover bad blocks (using the command 
INITIALIZE/BADBLOCKS). You have a choice of replacing or covering bad blocks 
if your disk is MSCP or is an RK06, RK07, RLOl, or RL02. (Refer to the RT- 
11 Commands Manual.) If your disk is another type, you should use INITIALIZE 
/BADBLOCKS to cover any bad blocks. If the disk contains bad blocks, the ?DUP-W- 
Bad blocks detected nnnnnn message appears on the terminal, but you can use the 
disk. In the commands, xx is the permanent device name and n is the unit number 
for your disk. 

RL02 disk 

.INITIALIZE/BADBLOCKS DLn: [ret] 

DLn: /Initialize; Are you sure? Y |ret| 

7DUP-I-NO bad blocks detected DLn: 

Other type disk 

.INITIALIZE/BADBLOCKS xxn : [ret] 

xxn: /Initialize; Are you sure? Y |ret| 

?DUP-I-No bad blocks detected xxn: 

or 

.INITIALIZE/REPLACE xxn: [ret] 

xxn: /Initialize; Are you sure? Y |ret| 

?DUP-I-No bad blocks detected xxn: 

The system scans the disk for bad blocks and creates a new directory. The monitor 
dot ( . ) appears when this process is complete. 

The next step in the preservation process is to copy all the files from the distribution 
disk to the initialized blank disk. 

The following command transfers files from the distribution to the backup disk and 
consolidates all the empty space at the end of the disk. In the command, yyn is the 
device name and unit number of your distribution disk, and xxn is the device name 
and unit number of your backup disk. 

. SQUEEZE/OUTPUT : xxn : yyn : 



NOTE 

Both the SQUEEZE command with the /OUTPUT:xxn: 
option and the COPY command transfer files from 
one device to another. SQUEEZE/OUTPUT:xxn: 
consolidates free space on the device at the same time. 
The procedures in this manual use the command that is 
most appropriate and most efficient for an individual 
operation. For a better understanding of all RT- 
11 keyboard monitor commands, refer to the RT-11 
Commands Manual. 

Next, copy the bootstrap to the backup disk. 
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.COPY /BOOT xxn-.RTllFB.SYS xxn : 

Now, halt the processor, remove the distribution disk from Unit 0, and store it. 
Mount the backup disk on Unit 0, and use the hardware bootstrap to boot the backup 
disk. 

RT-llFB V05.XX 
(Followed by any start-up file commands.) 



NOTE 

If the backup disk does not boot, repeat the procedures 
to this point. 

Next, remove the protection from all the files on the backup disk. The files on the 
distribution disk have been protected to prevent you from accidentally deleting them. 
(Refer to the RT-11 Commands Manual for a description of file protection.) When 
you copied the files to the backup disk, RT-11 also copied the protection. (Note the 
P that prints next to the file size in the directory.) For the rest of these procedures, 
remove the protection from the backup disk. Use the following command: 

. UNPROTECT/ SYSTEM * . * [ret] 
Files unprotected: 
DK -.aaaaaa.ttt 
DK-.bbbbbb.ttt 
DK : cccccc .ttt 
DK:dddddd.ttt 



DK: zzzzzz . ttt 



5.3 Creating the Working System from Chosen Components 

Once you have chosen your system components (Section 2.4) and have planned the 
best arrangement of them on a disk (Section 2.5), you can create the working system 
by copying selected components to another disk or disks. 

Mount a blank disk in disk Unit 1 and initialize it. (If the disk is an RK05 disk, 
format it before you initialize it.) 

RL02 disk 

. INITIALIZE/BADBLOCKS DLl : [ret] 

DLl : /Initialize; Are you sure? Y |ret| 

?DUP-I-No bad blocks detected DLl: 

Other type disk 

.INITIALIZE/BADBLOCKS xxl : [ret] 

xxl : /Initialize; Are you sure? Y |ret| 

7DUP-I-NO bad blocks detected xxl : 
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or 

.INITIALIZE/REPLACE xxl : [ret] 

xxl : /Initialize; Are you sure? Y |ret| 

7DUP-I-NO bad blocks detected xxl : 

Copy the files you have selected from the disk in Unit to the disk in Unit 1, which 
will become your working system disk. If you use the following command, RT-11 
queries you about all the files on the disk in Unit 0, and you can choose the files it 
copies. 



.COPY/SYSTEM/QUERY xxO : xxl: 

Files copied: 
xxO : aaaaaa . ttt to xxl :aaaaaa.ttt? Y |ret| (includes aaaaaa.ttt) 
xxO:bbbbbb.ttt to xxl:bbbbbb.ttt? N \^ (excludes bbbbbb.ttt) 

(and so on) 

5.4 Installing the Bootstrap on the Disk 

Once you have created your system, install the bootstrap on the system disk. In the 
following command, aa is SB, FB, or one of the mapped monitors. 

.COPY/BOOT xxl:RTllaa.SYS xxl: [Rfr] 

In this command, you identify the device on which the monitor that contains the 
bootstrap information resides (your disk), the name of that monitor file, and the 
device on which you need to install the bootstrap (your disk). This command copies 
bootstrap information from the monitor file to blocks and 2 through 5 of the same 
disk. 

Remove the disk from Unit and store it for future updates. Mount the new working 
system disk in Unit 0, and use the hardware bootstrap to boot the working system 
disk. 

RT-llaa V05.XX 
(Followed by any start-up file commands.) 



5.5 Customizing the System 

You may want to make customizations (described in Section 2.6) to the distributed 
RT-11 components. At this point, perform the procedures to implement any of these 
software customizations. Table 1-2 summarizes the available customizations and 
directs you to the section in Chapter 2 that describes a particular customization and 
the procedure for implementing it. 

NOTE 

Later, you can perform the system generation process to 
implement additional customizations. (See Section 5.9.) 
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5.6 Compressing the Disk 

Digital recommends that you compress the working system disk to make its free 
space contiguous. Consohdating free space allows you to use space on the disk that 
would otherwise be too fragmented to be usable. 

Use the SQUEEZE command to compress free space. (The volume must be write 
enabled.) The squeeze operation does not move files with the .BAD file type. 

.SQUEEZE xxO: |ret| 

xxO: /Squeeze; Are you sure? Y |ret| 

RT-llaa V05.XX 

(Followed by any start-up file commands.) 

The system automatically reboots when you compress a system disk. 

5.7 Preserving the Working System 

Once you build a satisfactory working system, Digital recommends that you preserve 
it on the backup medium of your choice. The following sections describe backup on 
disk. If you want to back up the system on another device, the procedure may appear 
elsewhere in this manual; refer to the table of contents. 

To back up your system on another disk, initialize a blank disk and copy all the files 
from the working system disk to the backup disk. In the following commands, xxn 
is the device name and unit number for the backup working system disk. 

RL02 disk 

. INITIALIZE/BADBLOCKS DLl : [ret] 

DLl : /Initialize; Are you sure? Y |ret| 

7DUP-I-NO bad blocks detected DLl: 

Other type disk 

.INITIALIZE/BADBLOCKS xxl : [ret] 

xxl : /Initialize; Are you sure? Y |ret| 

7DUP-I-NO bad blocks detected xxl : 



or 

.INITIALIZE/REPLACE xxl: [ret] 

xxl : /Initialize; Are you sure? Y |ret| 

7DUP-I-NO bad blocks detected xxl : 

Copy all the files in your working system. In the following command, yyn is the 
device name and unit number for your working system, and xxn is the device name 
and unit number for the backup working system disk: 

. SQUEEZE/OUTPUT : xxn : yyn: [ret] 

Copy the bootstrap to the backup working system disk. In the following command, 
aa is SB, FB, or one of the mapped monitors. 
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.COPY /BOOT xxl:RTllaa.SYS xxl : 

Store the backup working system disk. If you ever need to restore the working 
system, you can make a copy of the backup working system disk. 

5.8 Testing the Working System 

Once you have built and preserved the working system, you can execute the 
following demonstration to test that system. This demonstration does not serve 
as a comprehensive system exercise; however, because it uses several major system 
components, it does serve as a minimal integrity check. Moreover, Digital considers 
your system officially installed if the demonstration runs without error. 

To execute this demonstration, your working system must include at least the 
following components: 

SWAP.SYS 

RTllFB.SYS 

XX. SYS (system device handler) 

LP.SYS (or LS.SYS) 

KED.SAV 

MACRO.SAV 

SYSMAC.SML 

LINK.SAV 

PIP.SAV 

DUP.SAV 

DIR.SAV 

DEMOBG.MAC 

DEMOFG.MAC 

Display the directory of the system volume on the terminal. The directory varies 
according to your working system. As long as a directory prints, you need not worry 
if it does not match the one in the following example. 

.DIRECTORY/BRIEF/COLUMNS : 1 SY: [retI 

dd-nmim-yy 
SWAP . SYS 
RTllFB.SYS 
LP . SYS 

DL . SYS 

RED . SAV 

MACRO .SAV 
SYSMAC.SML 
LINK . SAV 
PIP . SAV 



XXX Files, bbb Blocks 
fff Free blocks 
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NOTE 

If you have shifted output to your terminal and the 
directory scrolls by too quickly to read, press |ctrus| 
or I HOLD screen] to stop the display and |ctruq| or 
I HOLD screen] again to restart it. 

Before you can execute the background and foreground demonstration programs, 
you must first edit, assemble, and link the background program, DEMOBG.MAC, 
and you must assemble and link the foreground program, DEMOFG.MAC. 

5.8.1 Preparing the Background Demonstration Program 

5.8.1.1 Edit the Background Demonstration Program 

Use the KED text editor to modify the background demonstration program, 
DEMOBG.MAC. One of the output lines in the program is preceded by a semicolon, 
which makes the line a comment field. The semicolon prevents the line from 
being printed; thus, it must be deleted from that line. If DEMOBG.MAC 
is a protected file, you must remove the protection before making the edits 
(UNPROTECT SY:DEMOBG.MAC). The following commands and keypad strokes 
open DEMOBG.MAC for editing and remove the semicolon from the file: 



.EDIT SY: DEMOBG.MAC 

1 PF1 1 1 PF3 1 


|ret| 


Model? ; ItabI .ASCII 


1 4 1 


1 PF1 1 1 7 1 




Command? EXIT | enter | 





5.8.1.2 Assemble thie Bacl<ground Demonstration Program 

The background program, DEMOBG.MAC, is an assembly language source file; it 
must be assembled and linked before you can execute it. To assemble DEMOBG.MAC 
and obtain a printed listing, first make sure that your configuration has an on-line 
printer that is ready and issue the following commands: 

.ASSIGN LS LP [ret] 
.ASSIGN LP LST [Rfr] 

If your configuration does not include a printer, use the console terminal: 

.ASSIGN TT LST [Rfr] 

Next, assemble DEMOBG.MAC as follows: 

.MACRO/LIST: LST: DEMOBG \^ 

(See Figure 5-1.) 

If any errors occur when you assemble DEMOBG.MAC, you have incorrectly edited 
the file and should repeat the edits. Use the backup demonstration program. 

.RENAME SY : DEMOBG . BAR SY : DEMOBG . MAC \^\ 
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Figure 5-1 : DEMOBG Assembly Listing 
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000777 



1 
2 
3 
4 
5 
6 
7 

8 000000 

9 000034 
10 000042 
11 
12 
13 

14 000044 

15 000052 

16 000106 
17 
18 
19 

20 000110 
21 

22 000112 

23 000147 

24 000225 

25 000237 
26 

27 000240 

28 000254 

29 OOOOi 
DEMOBG MACRO V05 . 05 
Symbol table 

AREA 000240R 

BELL OOOllOR 

BUFFER 000254R 

. ABS. 000000 000 

000254 001 

Errors detected: 



. TITLE DEMOBG 

.IDENT /V05.00/ 
; DEMONSTRATION PROGRAM TO PRINT DEMONSTRATION MESSAGE, THEN 
; RING BELL IF FG JOB SENDS A MESSAGE. 

.MCALL .RCVDC, .PRINT 

START:: .RCVDC iAREA, #BUFFER, #400, #MSGIN ;POST REQUEST FOR MESSAGE 
.PRINT #MSG ; PRINT DEMONSTRATION MESSAGE 

BR ;AND LOOP 

; COMPLETION ROUTINE ENTERED WHEN FG SENDS MESSAGE 

MSGIN: .PRINT iBELL ;RING BELL IN RESPONSE TO MESSAGE 

.RCVDC #AREA,#BUFFER,#400,#MSGIN ; POST ANOTHER MESSAGE REQUEST 
RETURN ;AND RETURN FROM COMPLETION ROUTINE 



007 BELL: 

122 MSG: 

111 

127 

000 

AREA: 
BUFFER: 



ASCII MESSAGES 
.NLIST BEX 
.BYTE 7,200 



; MESSAGE THAT RINGS BELL 



.ASCII /RT-11 DEMONSTRATION PROGRAM/<lS><12> 

.ASCII /IF INCORRECTLY EDITED, THIS IS THE LAST LINE. /<1S><12> 

.ASCII /WELL DONE./ 

. BYTE 

.BLKW 6 ;EMT ARGUMENT AREA 

; RCVDC MESSAGE AREA 
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MSG 000112R 

MSGIN 000044R 
START OOOOOORG 

(RW, I, GBL, ABS, OVR) 
(RW, I, LCL, PEL, CON) 



. .VI = 000003 
. .V2 = 000027 



*** Assembler statistics 



Work file reads: 









Work file writes: 









Size of work file: 


10912 


Words 


( 43 Pages) 


Size of core pool : 


21760 


Words 


( 85 Pages) 


Operating system: 


RT-11 







Elapsed time: 00:00:06.16 
DEMOBG, DEMOBG/L : TTM=DEMOBG 

5.8.1.3 Linic the Bacl<ground Demonstration Program 

Link the program DEMOBG. OBJ to produce an executable background program, 
DEMOBG.SAV. 

.LINK DEMOBG [rIt] 



Installing a System Distributed on RL02 to Run on Hard Disk 5-9 



5.8.1.4 Run the Background Demonstration Program 

Run the program DEMOBG to check the results of the first exercise. 

.RUN DEMOBG [rIi] 
RT-11 DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED, THIS IS THE LAST LINE. 
WELL DONE. 

If you did not delete the semicolon character, the last line will not print. Return to 
the monitor by twice pressing CTRL/C: 



I CTRL/C I 
I CTRL/C I 



If you incorrectly edited the file, you can repeat this exercise, although you can 
continue without correcting the file. However, if you want to repeat the exercise, 
begin by using the backup demonstration program. 

.RENAME SY : DEMOBG . BAK SY : DEMOBG . MAC \^ 

Then, repeat the editing procedure. 

5.8.2 Preparing the Foreground Demonstration Program 

DEMOFG.MAC is a small foreground program that sends a message every 2 seconds 
to DEMOBG (running in the background), telling it to ring the terminal bell. 
DEMOBG recognizes these messages and rings the bell once for each message sent. 

Although DEMOFG is always active, sending messages to the background every 2 
seconds, the circuit is complete and messages are successfully received and honored 
only when DEMOBG is active. During those periods when DEMOBG is not running, 
DEMOFG enters the messages in the monitor message queue. Once you restart 
DEMOBG in the background, the system immediately releases all the messages 
queued since the last forced exit, resulting in many successive bell rings. When the 
queue is empty, the normal send/receive cycle resumes and the bell rings every 2 
seconds as each current message is sent and honored. 

To execute the foreground program, assemble the program DEMOFG.MAC, link it 
for the foreground, and execute it in conjunction with DEMOBG.SAV. 

5.8.2.1 Assemble the Foreground Demonstration Program 

The foreground demonstration program, DEMOFG.MAC, is an assembly language 
source file; it must be assembled and linked before you can use it. Assemble 
DEMOFG.MAC as follows: 

. MACRO/LIST :LST: DEMOFG \^ 

The output resulting from this MACRO command is an object file called 
DEMOFG.OBJ. This file resides on your system volume. 
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5.8.2.2 Link the Foreground Demonstration Program 

You must link the DEMOFG.OBJ file to produce an executable program. Use the 
/FOREGROUND option to produce the load module DEMOFG.REL. The .REL file 
type signifies to the system that the file is a foreground program and is to be run as 
the priority job. 

.LINK/FOREGROUND DEMOFG \^ 

5.8.2.3 Run the Foreground and Background Demonstration Programs 

Type the following command to load and start DEMOFG.REL as the foreground job. 

.FRUN DEMOFG [ret] 

F> 

FOREGROUND DEMONSTRATION PROGRAM 

SENDS A MESSAGE TO THE BACKGROUND PROGRAM DEMOBG 

EVERY 2 SECONDS, TELLING IT TO RING THE BELL. 



B> 

DEMOFG.REL is now running and queuing the message for DEMOBG every 2 
seconds. Now execute DEMOBG.SAV in the background and receive the messages. 

.RUN DEMOBG \^] 

(The bell rings quickly several times, then once every 2 seconds.) 

RT-11 DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED, THIS IS THE LAST LINE. 

WELL DONE. 

Execute a DIRECTORY command in the background to obtain a directory listing. 



(The bell stops ringing.) 
.DIRECTORY [ret] 
dd-mmm-yy 
(The directory of the device DK prints on the terminal . ) 

Rerun DEMOBG to collect all the foreground messages queued while the directory 
was printing. 

.RUN DEMOBG [Rfr] 

(The bell rings several times in rapid succession, then rings once every 2 seconds.) 

RT-11 DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED, THIS IS THE LAST LINE. 

WELL DONE. 



CTRL/C 



(The bell stops ringing. ) 
Now, stop the foreground program and remove it from memory. 
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I CTRL/F I 

F> 

I CTRL/C I 
I CTRL/C I 

B> 
UNLOAD F 



If you completed these exercises without error, your system has passed this minimal 
test and you can consider it successfully installed. 

5.9 Performing the System Generation Process 

If you have decided that you need RT-11 features that are available only if you 
generate your own monitor(s) and handlers, perform the system generation process 
at this point. You should have thoroughly studied Chapter 1 to make this decision 
and to establish that you can perform the system generation process on your 
hardware configuration. Read the RT-11 System Generation Guide for guidance 
in planning and performing system generation. 

5.10 Further Information 

After installing RT-11, read the Introduction to RT-11. The Introduction to RT-11 
provides a tutorial interactive explanation of RT-11. 
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Chapter 6 

Installing a System Distributed on RL02 to Run on a 

Small Device 

If your distribution media is an RL02 hard disk and you intend to build a system 
to run on a small device (RXOl, RX02, or RX50), perform the procedures described 
in this chapter. These procedures assume that your configuration includes two hard 
disk drives (not necessarily of the same type). 

NOTE 

If your hardware configuration includes a VTIOO 
terminal, be sure to set AUTO XON/XOFF in SETUP 
mode B before attempting to bootstrap RT-11. Do not 
set TT NOPAGE when you use this terminal. Refer 
to your hardware manuals for more information about 
these settings. 

To install your system, perform the steps in the following list. Sections 6.1 through 
6.9 describe the procedures for each step. 

1. Bootstrap the distribution disk. 

2. Preserve the distribution disk. 

3. Create the working system from chosen components. 

4. Install the bootstrap on diskettes that need to be bootable. 

5. Customize the system. 

6. Compress each diskette. 

7. Preserve the working system. 

8. Test the working system. 

9. If appropriate, perform the system generation process. 

10. Read the Introduction to RT-11 for more information on using RT-11. 

6.1 Bootstrapping the Distribution Disk 

The first procedure you perform when installing RT-11 is bootstrapping the 
distribution disk. 

Begin by making sure that the processor is powered up but not running. Mount 
the distribution disk (write-protected) in disk Unit 0. The device name is DL. Use 



Installing a System Distributed on RL02 to Run on a Small Device 6-1 



the hardware bootstrap to boot the disk. (If your configuration does not include a 
hardware bootstrap, refer to Appendix B for the toggle-in software bootstrap.) 

RL02 disks are normally installed manually. If you successfully bootstrap an RL02 
disk, RT-11 responds with the following dialog and installation verification message. 
The dialog gives you the choice of installing RT-11 manually or by using the 
automatic installation procedure. 

Welcome to RT-11 Version 5. 

You have bootstrapped the RT-11 Distribution Disk. Use this disk to 
install your RT-11 system, then store it in a safe place. 

RT-11 V5 provides an automatic installation procedure which will 
back up your distribution disk and build a working system disk which 
should be used for your work with RT-11. This working system disk 
will only contain the RT-11 operating system. After the RT-11 
installation is complete, follow the installation instructions 
packaged with any optional languages or utility software which you 
will be using. 

Press the "RETURN" key when ready to continue. |ret| 

you can choose to install RT-11 manually . This procedure is 

described in the RT-11 Installation Guide. 

If you are a new user of RT-11, Digital highly recommends that you 
use the automatic installation procedure. 

Do you want to use the automatic installation procedure? 
(Type YES or NO and press the "RETURN" key) : NO [ret] 

The standard RT-11 monitor bootstrap (RTllFB) will now be 
copied to this disk and this system disk will be rebooted. 
Please refer to the RT-11 Installation Guide for assistance 
while manually installing RT-11 Version 5. 



Press the "RETURN" key when ready to continue . 

RT-llFB V05.XX 

.TYPE V5USER.TXT 

RT-11 V5.XX 

Installation of RT-11. . . . (followed by V5USER.TXT message) .... 

Now you can edit the start-up file to turn on or create any commands or sequence 
of commands that you would normally want to execute when you boot the processor. 
Editing start-up command files is described in the Introduction to RT-11. 

6.2 Preserving the Distribution Disk 

The first procedure you perform with the running RT-11 system is to copy the 
distribution disk for backup, as a safety measure in case of machine failure or 
human error. You can then use the backup copy of the distribution disk to build 
your working system. 

Mount a blank disk in the other disk drive, if necessary. If the disk is an RK05 disk, 
format it, and then initialize it and cover any bad blocks on it. 
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If the disk is another type, initialize the disk and replace bad blocks (using 
the command INITIALIZE/REPLACE) or cover bad blocks (using the command 
INITIALIZE/BADBLOCKS). You have a choice of replacing or covering bad blocks 
if your disk is MSCP or is an RK06, RK07, RLOl, or RL02. (Refer to the RT- 
11 Commands Manual.) If your disk is another type, you should use INITIALIZE 
/BADBLOCKS to cover any bad blocks. If the disk contains bad blocks, the ?DUP-W- 
Bad blocks detected nnnnnn message appears on the terminal, but you can use the 
disk. In the commands, xx is the permanent device name and n is the unit number 
for your disk. 

RL02 disk 

.INITIALIZE/BADBLOCKS DLn: [ret] 

DLn: /Initialize; Are you sure? Y |ret| 

7DUP-I-NO bad blocks detected DLn: 

Other type disk 

.INITIALIZE/BADBLOCKS xxn : [ret] 

xxn: /Initialize; Are you sure? Y |ret| 

?DUP-I-No bad blocks detected xxn: 

or 

.INITIALIZE/REPLACE xxn: [ret] 

xxn: /Initialize; Are you sure? Y |ret| 

?DUP-I-No bad blocks detected xxn: 

The system scans the disk for bad blocks and creates a new directory. The monitor 
dot ( . ) appears when this process is complete. 

The next step in the preservation process is to copy all the files from the distribution 
disk to the initialized blank disk. 

The following command transfers files from the distribution to the backup disk and 
consolidates all the empty space at the end of the disk. In the command, yyn is the 
device name and unit number of your distribution disk, and xxn is the device name 
and unit number of your backup disk. 

. SQUEEZE/OUTPUT : xxn : yyn : 



NOTE 

Both the SQUEEZE command with the /OUTPUT:xxn: 
option and the COPY command transfer files from 
one device to another. SQUEEZE/OUTPUT:xxn: 
consolidates free space on the device at the same time. 
The procedures in this manual use the command that is 
most appropriate and most efficient for an individual 
operation. For a better understanding of all RT- 
11 keyboard monitor commands, refer to the RT-11 
Commands Manual. 

Next, copy the bootstrap to the backup disk. 
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.COPY /BOOT xxn-.RTllFB.SYS xxn : 

Now, halt the processor, remove the distribution disk from Unit 0, and store it. 
Mount the backup disk on Unit 0, and use the hardware bootstrap to boot the backup 
disk. 

RT-llFB V05.XX 
(Followed by any start-up file commands.) 



NOTE 

If the backup disk does not boot, repeat the procedures 
to this point. 

Next, remove the protection from all the files on the backup disk. The files on the 
distribution disk have been protected to prevent you from accidentally deleting them. 
(Refer to the RT-11 Commands Manual for a description of file protection.) When 
you copied the files to the backup disk, RT-11 also copied the protection. (Note the 
P that prints next to the file size in the directory.) For the rest of these procedures, 
remove the protection from the backup disk. Use the following command: 

. UNPROTECT/ SYSTEM * . * [ret] 
Files unprotected: 
DK -.aaaaaa.ttt 
DK-.bbbbbb.ttt 
DK : cccccc .ttt 
DK:dddddd.ttt 



DK: zzzzzz . ttt 



6.3 Creating the Working System from Chosen Components 

Once you have chosen your system components (Section 2.4) and have planned the 
best arrangement of them on diskettes (Section 2.5), you can create the working 
system by copying selected components to blank diskettes. 

6.3.1 Initializing RX50 Diskettes 

If you wish to create your working system on RX50 diskettes, insert a blank RX50 
diskette in Unit 1 or 2 so you can initialize it. You can use the INITIALIZE command 
with the /BADBLOCKS option to initialize the diskette and to detect any bad blocks 
that may be on it. If the diskette contains bad blocks, the ?DUP-W-Bad blocks 
detected nnnnnn message appears on the terminal. In the command, x is the device 
unit number. 

NOTE 

RX50 diskettes are not formattable. Digital recommends 
that you use only diskettes that have no bad blocks. 
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To ascertain whether an already initiahzed diskette has 
bad blocks, use the command DIRECTORY/BAD DUn:. 
If bad blocks exist on a diskette, copy the contents of 
the diskette to an error-free diskette and dispose of the 
diskette with bad blocks. 



. INITIALIZE/BADBLOCKS DUx: 

DUx : /Initialize; Are you sure? Y |ret| 

7DUP-I-NO bad blocks detected DUx: 

There may be a delay of up to 1 minute while the system scans the diskette for bad 
blocks and creates a new directory. The monitor dot ( . ) appears when this process 
is complete. 

Now, remove the newly initialized diskette and initialize an adequate number of 
blank diskettes, leaving one initialized, blank, write-enabled (write-protect notch 
uncovered) diskette inserted in Unit 1 or 2. 

6.3.2 Formatting and Initializing RX01/RX02 Diskettes 

If you plan to create your working system on RXOl diskettes, initialize a number 
of blank RXOl diskettes. For RX02 diskettes, format and initialize the diskettes. 
Insert a blank diskette in Unit 1. Diskettes are available in single-density but not 
double-density format. Therefore, to create RX02 diskettes, you must format all 
your blank diskettes as double-density diskettes. You can use the FORMAT utility 
program to format the blank diskette and the INITIALIZE command to initialize it. 
Use the /BADBLOCKS option with INITIALIZE to cover any bad blocks that may 
be on your diskette. If the diskette contains bad blocks, the ?DUP-W-Bad blocks 
detected nnnnnn message appears on the terminal. 

NOTE 

Digital recommends that you use only diskettes that do 
not have bad blocks when you build a working system. 
To ascertain whether an already initialized diskette has 
bad blocks, use the command DIRECTORY/BAD DYn:. 
You can use diskettes with bad blocks later, for working 
or data volumes. 

For RX02 diskettes: 

.FORMAT DYl: [ret] 

DYl : /FORMAT-Are you sure? Y |ret| 

?FORMAT-I-Fonnatting complete 

.INITIALIZE/BADBLOCKS DYl: [ret] 

DYl: /Initialize; Are you sure? Y |ret| 

7DUP-I-NO bad blocks detected DYl: 

For RX01 diskettes, just initialize thie diskette: 

.INITIALIZE/BADBLOCKS DXl : [ret] 

DXl: /Initialize; Are you sure? Y |ret| 

?DUP-I-No bad blocks detected DXl: 
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The system scans the diskette for bad blocks and creates a new directory. The 
monitor dot ( . ) appears when this process is complete. 

Now, remove the newly formatted and initialized diskette. Repeat the process to 
create as many initialized blank diskettes as you need for the system that you have 
planned. Leave one diskette in Unit 1. 

6.3.3 Copying the Selected Files onto the Diskette 

Use the COPY command with the /SYSTEM option to copy selected files from the 
backup disk to the diskettes that will become your working system diskettes. The 
/SYSTEM option is required for copying .SYS files only if wildcards are used in the 
input file specification. In the command, yyn is the device name and unit number 
of your backup disk, and xxn is the device name and unit number of your working 
system diskettes. 

.COPY yyn: filnam.typ xxn: filnam.typ |ret| 

You can use the following command to avoid typing numerous file specifications. 
RT-11 queries you about all the files on the diskette, and you choose the files it 
copies. 

.COPY/SYSTEM/QUERY yyn: xxn: [rIt] 

Files copied: 
yyn : aaaaaa . ttt to xxn:aaaaaa.ttt? Y |ret| (includes aaaaaa.ttt) 
yyn:bbbbbb.ttt to xxn:bbbbbb.ttt? N \^ (excludes bbbbbb.ttt) 

(and so on) 

When you have copied all the files you planned for the working system diskette, 
label the diskette "RT-11 Working System V05 x/y" (where x is the diskette number, 
and y is the number of diskettes in your working system). 

6.4 Installing the Bootstrap on Any Diskettes That Need to Be 
Bootable 

Once you have created your working system diskettes, install the bootstrap on any 
diskettes that must be bootable (that is, that you can use as system diskettes). 
Generally, any diskette that includes a monitor file, SWAP.SYS, and system device 
handler should be bootable. 

Insert the diskette on which you need to install the bootstrap. In the following 
command, xxn represents the device name and unit number of your diskette, and aa 
is SB, FB, or one of the mapped monitors. 

.COPY/BOOT xxn:RTllaa.SYS xxn: [Rfr] 

In this command, you need to identify the device on which the monitor that contains 
the bootstrap information resides, the name of that monitor file, and the device on 
which you need to install the bootstrap. This command copies bootstrap information 
from the monitor file to blocks and 2 through 5 of the same diskette. 



6-6 RT-11 Installation Guide 



Then, insert working system diskette 1 in Unit and boot your working system. 
Use the hardware bootstrap if possible. If not, type the following command, where 
xxn represents the diskette to boot. 

.BOOT xxn: |ret| 

RT-llaa V05.XX 
(Followed by any start-up file commands.) 

Store your updated backup distribution disk for future updates. 

6.5 Customizing the System 

You may want to make customizations (described in Section 2.6) to the distributed 
RT-11 components. At this point, perform the procedures to implement any of these 
software customizations. Table 1-2 summarizes the available customizations and 
directs you to the section in Chapter 2 that describes a particular customization and 
the procedure for implementing it. 

NOTE 

Later, you can perform the system generation process to 
implement additional customizations. (See Section 6.9.) 

6.6 Compressing Each Diskette 

Digital recommends that you compress each working system diskette to make its free 
space contiguous. Consolidating free space allows you to use space on the diskette 
that would otherwise be too fragmented to be usable. 

Continue to run RT-11 from Unit and use the SQUEEZE command to compress 
free space. The squeeze operation does not move files with the .BAD file type. 

.SQUEEZE xxO: |ret| 

xxO: /Squeeze; Are you sure? Y |ret| 

There is a delay while the squeeze operation takes place. 

RT-llaa V05.XX 
(Followed by any start-up file commands.) 

The system automatically reboots when you compress a system diskette. 

Then, insert the next diskette that you need to compress in Unit 1. 

.SQUEEZE xxl: [ret] 

xxl: /Squeeze; Are you sure? Y |ret| 

Replace the diskette in Unit 1 with the next one you need to compress. Repeat this 
procedure for all the diskettes. 
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NOTE 

When you compress a diskette with system files (.SYS), 
PIP warns you to reboot. Do reboot as advised. 
When you compress a system diskette, the system 
automatically reboots. 

6.7 Preserving the Working System 

Once you build a satisfactory working system. Digital recommends that you protect 
all the files and preserve the system on backup diskettes. 

Use the following command to protect all the files on the system diskette: 

. PROTECT/SYSTEM * . * [ret] 
Files protected: 
DK -.aaaaaa.ttt 
DK-.bbbbbb.ttt 
DK : cccccc .ttt 
DK:dddddd.ttt 



DK: zzzzzz . ttt 

To protect files on other diskettes in the working system, insert each diskette in Unit 
1 and use the following command: 

. PROTECT/SYSTEM xxl :*.* [ret] 
Files protected: 
xxl : aaaaaa .ttt 
xxl:bbbbbb.ttt 
xxl : cccccc .ttt 
xxl:dddddd.ttt 



xxl : zzzzzz . ttt 

Next, copy the working system to backup diskettes. Insert a blank diskette in Unit 
1 with RT-11 still booted from Unit 0. Format (if you are using RX02 diskettes) and 
initialize the appropriate number of diskettes. 

Copy all the files in your working system. You can use the SQUEEZE/OUTPUT:xxl: 
xxO: command to copy any bootable diskettes. Remember to use SQUEEZEAVAIT 
/OUTPUT:xxl: xxO: and change diskettes to copy the diskettes that are not bootable. 
Also remember to copy the bootstrap to any diskettes that need to be bootable. 

Store the backup working system diskettes. To restore the working system, make 
copies of the backup working system diskettes. 
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6.8 Testing the Working System 

Once you have built and preserved the working system, you can execute the 
following demonstration to test that system. This demonstration does not serve 
as a comprehensive system exercise; however, because it uses several major system 
components, it does serve as a minimal integrity check. Moreover, Digital considers 
your system officially installed if the demonstration runs without error. 

To execute this demonstration, your working system must include at least the 
following components: 

SWAP.SYS 

RTllFB.SYS 

XX. SYS (system device handler) 

LP.SYS (or LS.SYS) 

KED.SAV 

MACRO.SAV 

SYSMAC.SML 

LINK.SAV 

PIP.SAV 

DUP.SAV 

DIR.SAV 

DEMOBG.MAC 

DEMOFG.MAC 

Display the directory of the system volume on the terminal. The directory varies 
according to your particular working system. As long as a directory prints, you need 
not worry if it does not match the one in the following example. 

.DIRECTORY/BRIEF/COLUMNS : 1 SY: [retI 

dd-nunm-yy 
SWAP . SYS 
RTllFB.SYS 
LP . SYS 

DY . SYS 

KED . SAV 

MACRO .SAV 
SYSMAC.SML 
LINK . SAV 
PIP . SAV 



XXX Files, bbb Blocks 
fff Free blocks 



NOTE 

If you have shifted output to your terminal and the 
directory scrolls by too quickly to read, press |ctrus| 
or I HOLD screen] to stop the display and |ctruq| or 
I HOLD screen] again to restart it. 
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Before you can execute the background and foreground demonstration programs, 
you must first edit, assemble, and link the background program, DEMOBG.MAC, 
and you must assemble and link the foreground program, DEMOFG.MAC. 

6.8.1 Preparing the Background Demonstration Program 

6.8.1.1 Edit the Background Demonstration Program 

Use the KED text editor to modify the background demonstration program, 
DEMOBG.MAC. One of the output lines in the program is preceded by a semicolon, 
which makes the line a comment field. The semicolon prevents the line from 
being printed; thus, it must be deleted from that line. If DEMOBG.MAC 
is a protected file, you must remove the protection before making the edits 
(UNPROTECT SY:DEMOBG.MAC). The following commands and keypad strokes 
open DEMOBG.MAC for editing and remove the semicolon from the file: 

.EDIT SY -.DEMOBG.MAC [rHI 



1 PF1 1 1 


PF3 1 




Model ? 


; [tab] . 


ASCII 1 4 1 


1 PF1 1 1 


7 1 




Command 


? EXIT 


1 ENTER 1 



6.8.1.2 Assemble thie Background Demonstration Program 

The background program, DEMOBG.MAC, is an assembly language source file; it 
must be assembled and linked before you can execute it. To assemble DEMOBG.MAC 
and obtain a printed listing, first make sure that your configuration has an on-line 
printer that is ready and issue the following commands: 

.ASSIGN LS LP [ret] 
.ASSIGN LP LST [Rfr] 

If your configuration does not include a printer, use the console terminal: 

.ASSIGN TT LST [Rfr] 

Next, assemble DEMOBG.MAC as follows: 

.MACRO/LIST: LST: DEMOBG \^ 

(See Figure 6-1.) 

If any errors occur when you assemble DEMOBG.MAC, you have incorrectly edited 
the file and should repeat the edits. Use the backup demonstration program. 

.RENAME SY : DEMOBG . BAK SY : DEMOBG . MAC \^] 
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Figure 6-1 : DEMOBG Assembly Listing 



DEMOBG MACRO V05.05 Sunday 13-Jan-91 13:33 Page 1 



000777 



1 
2 
3 
4 
5 
6 
7 

8 000000 

9 000034 
10 000042 
11 

12 
13 

14 000044 

15 000052 

16 000106 
17 

18 

19 

20 000110 

21 

22 000112 

23 000147 

24 000225 

25 000237 
26 

27 000240 

28 000254 
29 



DEMOBG MACRO V05 . 05 

Symbol table 

AREA 000240R 
BELL OOOllOR 

BUFFER 000254R 

. ABS. 000000 000 

000254 001 

Errors detected: 



. TITLE DEMOBG 

.IDENT /V05.00/ 
; DEMONSTRATION PROGRAM TO PRINT DEMONSTRATION MESSAGE, THEN 
; RING BELL IF FG JOB SENDS A MESSAGE. 

.MCALL .RCVDC, .PRINT 

START:: .RCVDC iAREA, #BUFFER, #400, #MSGIN ;POST REQUEST FOR MESSAGE 
.PRINT #MSG ; PRINT DEMONSTRATION MESSAGE 

BR ;AND LOOP 

; COMPLETION ROUTINE ENTERED WHEN FG SENDS MESSAGE 

MSGIN: .PRINT iBELL ;RING BELL IN RESPONSE TO MESSAGE 

.RCVDC #AREA,#BUFFER,#400,#MSGIN ; POST ANOTHER MESSAGE REQUEST 
RETURN ;AND RETURN FROM COMPLETION ROUTINE 

; ASCII MESSAGES 

.NLIST BEX 
.BYTE 7,200 



007 BELL: 



; MESSAGE THAT RINGS BELL 



122 MSG: 

111 

127 

000 



.ASCII /RT-11 DEMONSTRATION PROGRAM/<lS><12> 

.ASCII /IF INCORRECTLY EDITED, THIS IS THE LAST LINE. /<1S><12> 

.ASCII /WELL DONE./ 

. BYTE 



AREA: 
BUFFER: 



.BLKW 6 



;EMT ARGUMENT AREA 
; RCVDC MESSAGE AREA 
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MSG 000112R 

MSGIN 000044R 
START OOOOOORG 

(RW, I, GBL, ABS, OVR) 
(RW, I, LCL, REL, CON) 



. .VI = 000003 
. .V2 = 000027 



*** Asseiabler statistics 



Work file reads: 

Work file writes: 

Size of work file: 10912 Words 

Size of core pool: 21760 Words 

Operating system: RT-11 

Elapsed time: 00:00:06.16 
DEMOBG, DEMOBG/L : TTM=DEMOBG 



( 43 Pages) 
( 85 Pages) 



6.8.1.3 Linl< the Bacl<ground Demonstration Program 

Link the program DEMOBG. OBJ to produce an executable background program, 
DEMOBG.SAV. 

.LINK DEMOBG [rH] 

6.8.1.4 Run thie Background Demonstration Program 

Run the program DEMOBG to check the results of the first exercise. 
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.RUN DEMOBG \^\ 
RT-11 DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED, THIS IS THE LAST LINE. 
WELL DONE. 

If you did not delete the semicolon character, the last line will not print. Return to 
the monitor by twice pressing CTRL/C: 



I CTRL/C I 
I CTRL/C I 



If you incorrectly edited the file, you can repeat this exercise, although you can 
continue without correcting the file. However, if you want to repeat the exercise, 
begin by using the backup demonstration program. 



.RENAME SY: DEMOBG. BAK SY : DEMOBG . MAC 

Then, repeat the editing procedure. 

6.8.2 Preparing the Foreground Demonstration Program 

DEMOFG.MAC is a small foreground program that sends a message every 2 seconds 
to DEMOBG (running in the background), telling it to ring the terminal bell. 
DEMOBG recognizes these messages and rings the bell once for each message sent. 

Although DEMOFG is always active, sending messages to the background every 2 
seconds, the circuit is complete and messages are successfully received and honored 
only when DEMOBG is active. During those periods when DEMOBG is not running, 
DEMOFG enters the messages in the monitor message queue. Once you restart 
DEMOBG in the background, the system immediately releases all the messages 
queued since the last forced exit, resulting in many successive bell rings. When the 
queue is empty, the normal send/receive cycle resumes and the bell rings every 2 
seconds as each current message is sent and honored. 

To execute the foreground program, assemble the program DEMOFG.MAC, link it 
for the foreground, and execute it in conjunction with DEMOBG.SAV. 

6.8.2.1 Assemble the Foreground Demonstration Program 

The foreground demonstration program, DEMOFG.MAC, is an assembly language 
source file; it must be assembled and linked before you can use it. Assemble 
DEMOFG.MAC as follows: 

. MACRO/LIST :LST: DEMOFG \^ 

The output resulting from this MACRO command is an object file called 
DEMOFG.OBJ. This file resides on your system volume. 
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6.8.2.2 Link the Foreground Demonstration Program 

You must link the DEMOFG.OBJ file to produce an executable program. Use the 
/FOREGROUND option to produce the load module DEMOFG.REL. The .REL file 
type signifies to the system that the file is a foreground program and is to be run as 
the priority job. 

.LINK/FOREGROUND DEMOFG \^ 

6.8.2.3 Run the Foreground and Background Demonstration Programs 

Type the following command to load and start DEMOFG.REL as the foreground job. 

.FRUN DEMOFG [ret] 

F> 

FOREGROUND DEMONSTRATION PROGRAM 

SENDS A MESSAGE TO THE BACKGROUND PROGRAM DEMOBG 

EVERY 2 SECONDS, TELLING IT TO RING THE BELL. 



B> 

DEMOFG.REL is now running and queuing the message for DEMOBG every 2 
seconds. Now execute DEMOBG.SAV in the background and receive the messages. 

.RUN DEMOBG \^] 

(The bell rings quickly several times, then once every 2 seconds.) 

RT-11 DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED, THIS IS THE LAST LINE. 

WELL DONE. 

Execute a DIRECTORY command in the background to obtain a directory listing. 



(The bell stops ringing.) 
.DIRECTORY [ret] 
dd-mmm-yy 
(The directory of the device DK prints on the terminal . ) 

Rerun DEMOBG to collect all the foreground messages queued while the directory 
was printing. 

.RUN DEMOBG [Rfr] 

(The bell rings several times in rapid succession, then rings once every 2 seconds.) 

RT-11 DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED, THIS IS THE LAST LINE. 

WELL DONE. 



CTRL/C 



(The bell stops ringing. ) 
Now, stop the foreground program and remove it from memory. 
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I CTRL/F I 

F> 

I CTRL/C I 
I CTRL/C I 

B> 
UNLOAD F 



If you completed these exercises without error, your system has passed this minimal 
test and you can consider it successfully installed. 

6.9 Performing the System Generation Process 

If you need RT-11 features that are available only if you generate your own 
monitor(s) and handlers, perform the system generation process at this point. You 
should have thoroughly studied Chapter 1 to make this decision and to establish 
that you can perform the system generation process on your particular hardware 
configuration. Read the RT-11 System Generation Guide for guidance in planning 
and performing system generation. 

6.10 Further Information 

After installing RT-11, read the Introduction to RT-11. The Introduction to RT-11 
provides a tutorial interactive explanation of RT-11. 
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Chapter 7 

Installing a System Distributed on RX02 to Run on 
RX02 

If your distribution is on RX02 double-density diskettes, and you intend to build a 
system to run on double-density diskettes, perform the procedures described in this 
chapter. 

Your distribution kit contains two exact copies of the RT-11 operating system on 
RX02 diskettes. Store one copy of the RX02 diskettes in a safe place and do not 
modify their contents. They provide a backup (master) copy of the distributed RT- 
11 operating system. 

Store the second copy of diskettes in a safe place after installing software updates 
and creating your working system diskettes. Use these diskettes to create another 
working system. If these diskettes are ever damaged, use the master copy to 
reproduce them. 

NOTE 

If your hardware configuration includes a VTIOO 
terminal, be sure to set AUTO XON/XOFF in SETUP 
mode B before attempting to bootstrap RT-11. Do not 
set TT NOPAGE when you use this terminal. Refer 
to your hardware manuals for more information about 
these settings. 

To install your system, perform the steps in the following list. Sections 7.1 through 
7.8 describe the procedures for each step. 

1. Bootstrap the distribution diskette. 

2. Create the working system from chosen components. 

3. Install the bootstrap on diskettes that need to be bootable. 

4. Customize the system. 

5. Compress each diskette. 

6. Preserve the working system. 

7. Test the working system. 

8. If appropriate, perform the system generation process. 

9. Read the Introduction to RT-11 for more information on using RT-11. 
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7.1 Bootstrapping the Distribution Diskette 

The first procedure you perforin when instaUing RT-11 is to bootstrap distribution 
diskette 1. 

Begin by making sure that the processor is powered up but not running. Insert the 
distribution diskette labeled 1 in Unit (which has the physical device name DYO). 
Use the hardware bootstrap to boot the diskette. (If your configuration does not 
include a hardware bootstrap, see Appendix B for toggle-in software bootstraps.) 

RT-11 should respond with the following message if you have successfully 
bootstrapped the diskette: 

RT-llFB V05.XX 

.TYPE V5USER.TXT 
RT-11 V5.XX 

Installation of RT-11. . . . (followed by V5USER.TXT message) .... 

After you boot the system, you can edit the start-up file to turn on or enter any 
commands or sequence of commands that you would normally want to execute 
when you boot the processor. Editing start-up command files is described in the 
Introduction to RT-11. 

Next, remove the protection from all the files on the distribution diskettes. The files 
on the distribution diskettes have been protected to prevent you from accidentally 
deleting them. (Refer to the RT-11 Commands Manual for a description of file 
protection.) (Note the P that prints next to the file size in the directory.) For the rest 
of these procedures, you need to remove the protection from these diskettes. Type 
the following command to remove it from the files on distribution diskette 1: 

. UNPROTECT/ SYSTEM * . * [ret] 
Files unprotected: 
DK -.aaaaaa.ttt 
DK:bbbbbb.ttt 
DK : cccccc .ttt 
DK-.dddddd.ttt 



DK-.zzzzzz . ttt 



Insert distribution diskette 2 in Unit 1 and type the following command: 
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. UNPROTECT/ SYSTEM DYl :*.* 
Files unprotected: 
DYl : aaaaaa . ttt 
DYl:bbbbbb.ttt 
DYl : cccccc . ttt 
DYl-.dddddd.ttt 



DYl : zzzzzz . ttt 



Replace distribution diskette 2 with distribution diskette 3 in Unit 1 and repeat 
this command. In the same way, remove protection from the files on the remaining 
distribution diskettes. 

7.2 Creating the Working System from Chosen Components 

Once you have chosen your system components (Section 2.4) and have planned the 
best arrangement of them on diskettes (Section 2.5), you can create the working 
system by copying selected components to formatted and initialized blank diskettes. 

Start by formatting and initializing a number of blank diskettes. Insert a blank 
diskette in Unit 1 so you can format and initialize it. Diskettes are available in 
single-density but not double-density format. Therefore, you must reformat all 
your blank diskettes as double-density diskettes. You can use the FORMAT utility 
program, which is included on distribution diskette 1, to format the blank diskettes 
and the INITIALIZE command to initiahze them. Use the /BADBLOCKS option with 
INITIALIZE to cover any bad blocks that may be on your diskettes. If a diskette 
contains bad blocks, the ?DUP-W-Bad blocks detected nnnnnn message appears on 
the terminal. 

NOTE 

Digital recommends that you use only diskettes that do 
not have bad blocks when you build a working system. 
To ascertain whether an already initialized diskette has 
bad blocks, use the command DIRECTORY/BAD DYn:. 
You can use diskettes with bad blocks later for working 
or data volumes. 

.FORMAT DYl: [ret] 

DYl : /FORMAT-Are you sure? Y |ret| 

?FORMAT-I-Formatting complete 



. INITIALIZE/BADBLOCKS DYl : 

DYl : /Initialize; Are you sure? Y |ret| 

?DUP-I-No bad blocks detected DYl: 

The system scans the diskette for bad blocks and creates a new directory. The 
monitor dot ( . ) appears when this process is complete. 

Repeat the process to create as many initialized blank diskettes as you need for the 
system that you have planned, leaving one initialized, blank diskette in Unit 1. 
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Then, use the COPY command with the /SYSTEM option to copy selected files from 
distribution diskette 1 to the diskette that becomes your working system diskette. 
The /SYSTEM option is required for copying .SYS files only if wildcards are used in 
input file specifications. 

.COPY DYO-.filnam.typ DYl : filnam.typ \^] 

You can use the following command to avoid typing numerous file specifications. 
RT-11 queries you about all the files on the diskette, and you choose the files it 
copies. 

.COPY /SYSTEM/ QUERY DYO : DYl: [ret] 

Files copied: 
DYO : aaaaaa . ttt to DYl :aaaaaa.ttt? Y |ret| (includes aaaaaa.ttt) 
DYO:bbbbbb.ttt to DYl :bbbbbb.ttt? N \^ (excludes bbbbbb.ttt) 

(and so on) 

To copy files from nonbootable diskettes, you have to alternate diskettes. 
Use the SET command to set the USR to NOSWAP. 

.SET USR NOSWAP [ret] 

Type the following command, where filnam.typ is the name of the file you want to 
copy. In this case, you cannot use the /QUERY option; you must specify individual 
files. 

.COPY/WAIT DYl: filnam.typ DYO : filnam.typ [ret] 
Mount input volume in DYl:; Continue? 

Place the diskette containing the file you want to copy in Unit 1. 

Y [ret] 

Mount output volume in DYO:; Continue? 

Replace the system diskette in Unit with the diskette to which you want to copy 
filnam.typ. 

Y [ret] 

Mount system volume in DYO:; Continue? 

Replace the diskette in Unit with backup diskette 1. 

Y [rIi] 

Repeat this procedure to copy all the files you planned for the working system 
diskette. When you have copied all the files, label the diskette "RT-11 Working 
System V05 1". Repeat these procedures to create the other diskettes in the working 
system. 

When you have created and labeled all the working system diskettes, you can permit 
the USR to swap again. 

.SET USR SWAP [rIi] 
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7.3 Installing the Bootstrap on Any Volumes That Need to Be 
Bootable 

Once you have created your system, install the bootstrap on any volumes that 
must be bootable (that is, that you can use as the system volume). Generally, any 
volume that includes a monitor file, SWAP.SYS, and system device handler should 
be bootable. 

Insert in Unit 1 the volume on which you need to install the bootstrap. In the 
following command, aa is SB, FB, or one of the mapped monitors. 

.COPY/BOOT DYl-.RTllaa.SYS DYl : [Rfr] 

In this command, you need to identify the device on which the monitor that contains 
the bootstrap information resides, the name of that monitor file, and the device on 
which you need to install the bootstrap. This command copies bootstrap information 
from the monitor file to blocks and 2 through 5 of the same volume. 

Then, insert working system volume 1 in Unit and use the hardware bootstrap to 
boot your working system. 

RT-llaa V05.XX 
(Followed by any start-up file commands.) 

Store the updated backup volumes for future updating. 

7.4 Customizing the System 

You may want to make customizations (described in Section 2.6) to the distributed 
RT-11 components. At this point, perform the procedures to implement any of these 
software customizations. Table 1-2 summarizes the available customizations and 
directs you to the section in Chapter 2 that describes a particular customization and 
the procedure for implementing it. 

NOTE 

Later, you can perform the system generation process to 
implement additional customizations. (See Section 7.8.) 

7.5 Compressing Each Diskette 

Digital recommends that you compress each working system diskette to make its free 
space contiguous. Consolidating free space allows you to use space on the volume 
that would otherwise be too fragmented to be usable. 

Continue to run RT-11 from Unit and use the SQUEEZE command to compress 
free space. (The volume must be write enabled.) The squeeze operation does not 
move files with the .BAD file type. 

.SQUEEZE DYO: [ret] 

DYO: /Squeeze; Are you sure? Y |ret| 
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There is a delay while the system compresses the volume. 

RT-llaa V05.XX 
(Followed by any start-up file commands.) 

The system automatically reboots when you compress a system volume. 

Then, insert the next (write-enabled) volume that you need to compress in Unit 1. 

.SQUEEZE DYl: [ret] 

DYl: /Squeeze; Are you sure? Y |ret| 

Replace the volume in Unit 1 with the next one you need to compress. Repeat this 
procedure for all the volumes you need to compress. 

NOTE 

When you compress a volume with system files (.SYS), 
PIP warns you to reboot. Do reboot as advised. 
When you compress a system volume, the system 
automatically reboots. 

7.6 Preserving the Working System 

Once you build a satisfactory working system. Digital recommends that you protect 
all the files in the working system and preserve the system on backup volumes. 

Use the following command to protect all the files on the system volume: 

. PROTECT /SYSTEM * . * [ret] 
Files protected: 
DK -.aaaaaa.ttt 
DK-.bbbbbb.ttt 
DK : cccccc .ttt 
DK-.dddddd.ttt 



DK: zzzzzz . ttt 

To protect files on other volumes in the working system, insert each volume in Unit 
1 and use the following command: 

.PROTECT /SYSTEM DYl :*.* [ret] 
Files protected: 
DYl : aaaaaa . ttt 
DYl:bbbbbb.ttt 
DYl : cccccc . ttt 
DYl:dddddd.ttt 



DYl : zzzzzz . ttt 
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Next, copy the working system to backup volumes. Insert a blank volume (write- 
enabled) in Unit 1 with RT-11 still booted from Unit 0. Use the INITIALIZE 
/BADBLOCKS command to initialize the blank volume. Then, repeat the process to 
initialize the appropriate number of volumes. 

Copy all the files in your working system. You can use the SQUEEZE/OUTPUT:DYn: 
command to copy any bootable volumes. Remember to use SQUEEZEAVAIT 
/OUTPUT:DYn: and change volumes to copy the volumes that are not bootable. 
Also, remember to copy the bootstrap to any volumes that need to be bootable. 

Write-protect the backup working system volumes, and store them. If you ever need 
to restore the working system, make copies of the backup working system volumes. 

7.7 Testing the Working System 

Once you have built and preserved the working system, you can execute the 
following demonstration to test that system. This demonstration does not serve 
as a comprehensive system exercise; however, because it uses several major system 
components, it does serve as a minimal integrity check. Moreover, Digital considers 
your system officially installed if the demonstration runs without error. 

To execute this demonstration, your working system must include at least the 
following components: 

SWAP.SYS 

RTllFB.SYS 

XX. SYS (system device handler) 

LP.SYS (or LS.SYS) 

KED.SAV 

MACRO.SAV 

SYSMAC.SML 

LINK.SAV 

PIPSAV 

DUPSAV 

DIR.SAV 

DEMOBG.MAC 

DEMOFG.MAC 

Display the directory of the system volume on the terminal. The directory varies 
according to your working system. As long as a directory prints, you need not worry 
if it does not match the one in the following example. 

.DIRECTORY/BRIEF/COLUMNS : 1 SY: [retI 

dd-mmm-yy 
SWAP . SYS 
RTllFB.SYS 
LP . SYS 

DY . SYS 

KED . SAV 

MACRO .SAV 
SYSMAC.SML 
LINK . SAV 
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PIP . SAV 



XXX Files, bbb Blocks 
fff Free blocks 



NOTE 

If you have shifted output to your terminal and the 
directory scrolls by too quickly to read, press |ctrus| 
or I HOLD screen] to stop the display and |ctruq| or 
I HOLD screen] again to restart it. 

Before you can execute the background and foreground demonstration programs, 
you must first edit, assemble, and link the background program, DEMOBG.MAC, 
and you must assemble and link the foreground program, DEMOFG.MAC. 

7.7.1 Preparing the Background Demonstration Program 
7.7.1.1 Edit the Background Demonstration Program 

Use the KED text editor to modify the background demonstration program, 
DEMOBG.MAC. One of the output lines in the program is preceded by a semicolon, 
which makes the line a comment field. The semicolon prevents the line from 
being printed; thus, it must be deleted from that line. If DEMOBG.MAC 
is a protected file, you must remove the protection before making the edits 
(UNPROTECT SY:DEMOBG.MAC). The following commands and keypad strokes 
open DEMOBG.MAC for editing and remove the semicolon from the file: 



.EDIT SY: DEMOBG.MAC 

1 PF1 1 1 PF3 1 


|ret| 


Model? ; ItabI .ASCII 


1 4 1 


1 PF1 1 1 7 1 




Command? EXIT | enter | 





7.7.1.2 Assemble thie Bacl<ground Demonstration Program 

The background program, DEMOBG.MAC, is an assembly language source file; it 
must be assembled and linked before you can execute it. To assemble DEMOBG.MAC 
and obtain a printed listing, first make sure that your configuration has an on-line 
printer that is ready and issue the following commands: 

.ASSIGN LS LP [ret] 
.ASSIGN LP LST 



If your configuration does not include a printer, use the console terminal: 

.ASSIGN TT LST [Rfr] 

Next, assemble DEMOBG.MAC as follows: 

.MACRO/LIST: LST: DEMOBG [ret] 
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(See Figure 7-1.) 

If any errors occur when you assemble DEMOBG.MAC, you have incorrectly edited 
the file and should repeat the edits. Use the backup demonstration program. 

.RENAME SY : DEMOBG . BAK SY : DEMOBG . MAC \^ 

Figure 7-1 : DEMOBG Assembly Listing 

DEMOBG MACRO V05.05 Sunday 13-Jan-91 13:33 Page 1 

1 . TITLE DEMOBG 

2 .IDENT /V05.00/ 

3 ; DEMONSTRATION PROGRAM TO PRINT DEMONSTRATION MESSAGE, THEN 

4 ; RING BELL IF FG JOB SENDS A MESSAGE. 
5 

6 .MCALL .RCVDC, .PRINT 

7 

8 000000 START:: .RCVDC #AREA, iBUFFER, #400, iMSGIN ;POST REQUEST FOR MESSAGE 

9 000034 .PRINT #MSG ; PRINT DEMONSTRATION MESSAGE 
10 000042 000777 BR ;AND LOOP 

11 

12 ; COMPLETION ROUTINE ENTERED WHEN FG SENDS MESSAGE 

13 

14 000044 MSGIN: .PRINT #BELL ; RING BELL IN RESPONSE TO MESSAGE 

15 000052 .RCVDC #AREA, #BUFFER, #400, #MSGIN ; POST ANOTHER MESSAGE REQUEST 

16 000106 000207 RETURN ;AND RETURN FROM COMPLETION ROUTINE 
17 

18 ; ASCII MESSAGES 

19 .NLIST BEX 

20 000110 007 BELL: .BYTE 7,200 ;MESSAGE THAT RINGS BELL 
21 

22 000112 122 MSG: .ASCII /RT-11 DEMONSTRATION PROGRAM/<lS><12> 

23 000147 111 .ASCII /IF INCORRECTLY EDITED, THIS IS THE LAST LINE. /<15><12> 

24 000225 127 .ASCII /WELL DONE./ 

25 000237 000 .BYTE 
26 

27 000240 AREA: .BLKW 6 ;EMT ARGUMENT AREA 

28 000254 BUFFER: ;RCVDC MESSAGE AREA 

29 000000' .END START 

DEMOBG MACRO V05.05 Sunday 13-Jan-91 13:33 Page 1-1 
Symbol table 



AREA 


000240R 




MSG 


000112R 


. . .VI 


= 000003 


BELL 


OOOllOR 




MSGIN 


000044R 


. . .V2 


= 000027 


BUFFER 


000254R 




START 


OOOOOORG 






. ABS. 


000000 


000 


(RW, I, 


GBL, ABS, OVR) 








000254 


001 


<RW, I, 


LCL, REL, CON) 






Errors 


detected: 














*** Assembler statistics 



Work file reads: 









Work file writes: 









Size of work file: 


10912 


Words 


( 43 Pages) 


Size of core pool : 


21760 


Words 


( 85 Pages) 


Operating system: 


RT-11 







Elapsed time: 00:00:06.16 
DEMOBG, DEMOBG/L : TTM=DEMOBG 
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7.7.1.3 Link the Background Demonstration Program 

Link the program DEMOBG.OBJ to produce an executable background program, 
DEMOBG.SAV. 

.LINK DEMOBG [fll] 

7.7.1.4 Run the Background Demonstration Program 

Run the program DEMOBG to check the results of the first exercise. 

.RUN DEMOBG [Rfr] 

RT-11 DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED, THIS IS THE LAST LINE. 

WELL DONE. 

If you did not delete the semicolon character, the last line will not print. Return to 
the monitor by twice pressing CTRL/C: 



If you incorrectly edited the file, you can repeat this exercise, although you can 
continue without correcting the file. However, if you want to repeat the exercise, 
begin by using the backup demonstration program. 

.RENAME SY : DEMOBG . BAK SY : DEMOBG . MAC [ret] 

Then, repeat the editing procedure. 

7.7.2 Preparing the Foreground Demonstration Program 

DEMOFG.MAC is a small foreground program that sends a message every 2 seconds 
to DEMOBG (running in the background), telling it to ring the terminal bell. 
DEMOBG recognizes these messages and rings the bell once for each message sent. 

Although DEMOFG is always active, sending messages to the background every 2 
seconds, the circuit is complete and messages are successfully received and honored 
only when DEMOBG is active. During those periods when DEMOBG is not running, 
DEMOFG enters the messages in the monitor message queue. Once you restart 
DEMOBG in the background, the system immediately releases all the messages 
queued since the last forced exit, resulting in many successive bell rings. When the 
queue is empty, the normal send/receive cycle resumes and the bell rings every 2 
seconds as each current message is sent and honored. 

To execute the foreground program, assemble the program DEMOFG.MAC, link it 
for the foreground, and execute it in conjunction with DEMOBG.SAV. 

7.7.2.1 Assemble the Foreground Demonstration Program 

The foreground demonstration program, DEMOFG.MAC, is an assembly language 
source file; it must be assembled and linked before you can use it. Assemble 
DEMOFG.MAC as follows: 
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. MACRO/LIST :LST: DEMOFG [flT] 

The output resulting from this MACRO command is an object file called 
DEMOFG.OBJ. This file resides on your system volume. 

7.7.2.2 Link the Foreground Demonstration Program 

You must link the DEMOFG.OBJ file to produce an executable program. Use the 
/FOREGROUND option to produce the load module DEMOFG.REL. The .REL file 
type signifies to the system that the file is a foreground program and is to be run as 
the priority job. 

.LINK/FOREGROUND DEMOFG \^] 

7.7.2.3 Run thie Foreground and Bacl<ground Demonstration Programs 

Type the following command to load and start DEMOFG.REL as the foreground job. 

.FRUN DEMOFG [ret] 
F> 

FOREGROUND DEMONSTRATION PROGRAM 

SENDS A MESSAGE TO THE BACKGROUND PROGRAM DEMOBG 
EVERY 2 SECONDS, TELLING IT TO RING THE BELL. 

I CTRL/B I 



B> 

DEMOFG.REL is now running and queuing the message for DEMOBG every 2 
seconds. Now execute DEMOBG.SAV in the background and receive the messages. 

.RUN DEMOBG [rIi] 

(The bell rings quickly several times, then once every 2 seconds.) 

RT-11 DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED, THIS IS THE LAST LINE. 

WELL DONE. 

Execute a DIRECTORY command in the background to obtain a directory listing. 



CTRL/C 



(The bell stops ringing. ) 
.DIRECTORY [ret] 
dd-mmm-yy 
(The directory of the device DK prints on the terminal . ) 

Rerun DEMOBG to collect all the foreground messages queued while the directory 
was printing. 

.RUN DEMOBG \r^ 

(The bell rings several times in rapid succession, then rings once every 2 seconds.) 
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RT-11 DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED, THIS IS THE LAST LINE. 

WELL DONE. 



CTRL/C 



(The bell stops ringing. ) 
Now, stop the foreground program and remove it from memory. 



CTRL/F 



F> 



I CTRL/C I 
I CTRL/C I 



B> 

UNLOAD F [rHI 

If you completed these exercises without error, your system has passed this minimal 
test and you can consider it successfully installed. 

7.8 Performing the System Generation Process 

If you need RT-11 features that are available only if you generate your own 
monitor(s) and handlers, you have at least two possible courses of action. 

You can attempt a system generation on the RX02 system. Note that the RT- 
11 System Generation Guide does not recommend attempting a system generation 
with an RX02 configuration. Although perhaps possible, the procedure with this 
configuration is difficult, complicated, and very time consuming. 

If possible, perform the system generation on a computer system containing more 
suitable storage media and then use the generated modules on your RX02 system. 

7.9 Further Information 

After installing RT-11, read the Introduction to RT-11. The Introduction to RT-11 
provides a tutorial interactive explanation of RT-11. 
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Chapter 8 

Installing a System Distributed on Magtape to Run on 
Hard Disk 

If your distribution is on magtape, and you intend to build a system to run on 
hard disk, you can install the system automatically or manually. If you decide to 
install the system manually, perform the procedures described in this chapter. These 
procedures assume that your configuration includes only one disk drive. With two 
disk drives, you still have to perform the logical steps summarized in the following 
list; however, you can simplify some procedures by using the additional disk drive. 

NOTE 

If your hardware configuration includes a VTIOO 
terminal, be sure to set AUTO XON/XOFF in SETUP 
mode B before attempting to bootstrap RT-11. Do not 
set TT NOPAGE when you use this terminal. Refer 
to your hardware manuals for more information about 
these settings. 

Sections 8.1 through 8.10 describe the procedures for each of the following steps. 

1. Bootstrap the first distribution magtape. 

2. Preserve both distribution magtapes. 

3. Create bootable master magtapes. 

4. Create the working system on the disk from chosen components. 

5. Install the bootstrap on the disk. 

6. Customize the system. 

7. Compress the disk. 

8. Preserve the working system. 

9. Test the working system. 

10. If appropriate, perform the system generation process. 

11. Read the Introduction to RT-11 for more information on using RT-11. 
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8.1 Bootstrapping the First Distribution Magtape 

The first procedure you perforin when instaUing RT-11 is to bootstrap the first 
distribution magtape. (If your distribution is a TMSCP magtape cartridge, you have 
only one magtape and this procedure is the same except where indicated otherwise.) 

Begin by making sure that the processor is powered up but not running. If your 
distribution magtape is the 9-track reel, mount the magtape labeled 1/2 (remove the 
write ring from the back of the tape reel). Manually position the magtape at the load 
point if the magtape is not in this position. If your distribution is a TK50 cartridge, 
insert the magtape as descibed in your system documentation. 

If your system has a hardware bootstrap capable of bootstrapping the magtape, boot 
the tape and proceed. If not, use the appropriate toggle-in software bootstrap in 
Appendix B. 

The magtape moves as the primary bootstrap loads the secondary bootstrap file 
MSBOOTBOT 

MSBOOT responds on the terminal. 

MSBOOT VOx-yy 
* 

The next step depends on whether you have a TMll, TSll, TJU16 or TMSCP as 
a magtape device. If you have a TMll, use the magtape build program named 
MDUP.MT. If you have a TSll, use the magtape build program named MDUPMS. 
If you have a TJU16, use the magtape build program named MDUP.MM. If you 
have a TMSCP, use the magtape build program named MDUPMU. Issue one of the 
following commands: 

.MDUP.MT [rHI 

.MDUP.MS [rHI 

.MDUP.MM [ret] 

or 

.MDUP.MU [ret] 

The magtape moves as the specified MDUP program is loaded. 

MDUP VOx.yy 
* 

The next procedure is to build a minimal system on the disk. Start by initializing 
the system disk. If your disk is an RK05, be sure to use a formatted disk. 

You need to initialize the system disk and scan it for bad blocks before you can copy 
system files to it. You specify these operations to MDUP by entering the device name 
followed by combinations of the following options. 

/Z to initialize the disk 
/B to scan it for bad blocks 

Mount a formatted disk (write-enabled). 
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Use the following command, where xx is the permanent device name (RK, DL,DM, 
or DU) for your disk. 

*xxO:/z/B [r13 

The system scans the disk for bad blocks and creates a directory. 



Now you can build a minimal system on the disk. Depending on the type of tape 
drive you have, use one of the two following commands (where xx is the permanent 
device name for your disk). 

If the magtape is TMll: 

*xxO:A=MTO: [rIi] 

If the magtape is TSll: 

*xxO:A=MSO: [ret] 

If the magtape is TJU16: 

*xxO : A=MMO : |ret| 

If the magtape is TMSCP: 

*xxO : A=MUO : |ret| 

The tape moves while the system copies the monitor, swap file, system device 
handler, terminal handler, line printer handler, magtape handler, PIP, DUP, and 
DIR to the disk. When the files are copied, MDUP boots the minimal system from 
the disk. 

RT-llSB V05.XX 

?KMON-F-File not found DK : STRTSB . COM 

You are now running from the minimal system on the disk. This minimal system 
supports enough file maintenance commands to allow you to complete the building 
process. 

NOTE 

MDUP does not support automatic replacement of bad 
blocks for MSCP, RK06, RK07, RLOl, and RL02 disks. If 
your disk is an MSCP, RK06, RK07, RLOl, or RL02 and 
you want automatic bad block replacement, you must 
initialize a second disk and copy your files to it at a 
later time. 

If you wish to set the date and time, use the DATE command to set the date (where 
dd-mmm-yy is the day, month, and year in the form lO-JAN-91); use the TIME 
command to set the time (where hh:mm:ss is the hour, minutes, and seconds). 

.DATE dd-mmm-yy |ret| 
.TIME hh:mm:ss |ret| 
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Now, copy the rest of the files from distribution magtape 1 to the disk. Use the 
following command, where xx is MM, MS, MT or MU: 

.COPY/SYSTEM/NOREPLACE xxO : * . * DK: [ret] 

Files copied: 
xxO : aaaaaa . ttt to DK : aaaaaa . ttt 



xxO : zzzzzz .ttt to DK: zzzzzz .ttt 
?PIP-W-Reboot 



NOTE 

You must use the /NOREPLACE option in this 
command, so that the files you copied to the disk when 
you built the minimal system will not be copied again. 
The system prints a message to tell you which files it 
does not copy (for example, SWAP. SYS not copied). 

If the distribution magtape was TK50, reboot as shown below. If the distribution 
magtape was the 2-volume reel-type, momentarily ignore the message to reboot 
your system. Remove distribution magtape 1 from your drive and install volume 
2. Repeat the command: 

.COPY/SYSTEM/NOREPLACE xxO : * . * DK: [ret] 

Reboot as advised. 

.BOOT SY: [r^ 

8.2 Preserving the Magtape Distribution 

Use the indirect command files MTB.COM, MSB.COM, or MUB.COM to preserve 
the distribution magtapes. 

NOTE 

Although RT-11 is not distributed on 800 bpi magtapes, 
the procedure to back up the distribution to 800 
bpi magtapes and create bootable magtapes is also 
described. 

• Use MTB.COM if your magtape is written at 800 bpi. 

• Use MSB.COM if your magtape is written at 1600 bpi. 

• Use MUB.COM if your magtape is a TK50. 

If your magtape device is 800 bpi or 1600 bpi, proceed to Section 8.2.1. If your 
magtape device is a TK50, proceed to Section 8.2.2. 
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8.2.1 Using MTB.COM and MSB.COM 

The following procedure describes using MTB.COM and MSB.COM: 

1. Mount a blank magtape in the tape drive. Ensure that the write ring is in the 
back of the reel and that the tape is positioned at the load point. 

2. Copy from the disk to your blank magtape those files that were on distribution 
magtape 1. To copy those files, invoke the indirect command file MTB.COM if 
your magtape is 9-track, 800 bpi. If your magtape is 9-track, 1600 bpi, invoke 
MSB.COM. (The commands you enter are shown below.) 

MTB.COM or MSB.COM initializes the blank magtape, writes the primary 
bootstrap on it, and copies a duplicate of distribution magtape 1. Before you 
invoke this indirect command file, use the ASSIGN command to assign the logical 
name BIN: to your disk device and the logical name KIT: to your tape drive. In 
the commands, xx is MT, MS, or MM, and yy is your disk. 

If your magtape is written at 800 bpi, issue: 



.ASSIGN xxn: KIT: 
.ASSIGN yyn: BIN: [ret] 
.$@MTB [r13 

If your magtape is written at 1600 bpi, issue: 

.ASSIGN xxn: KIT: [ret] 
.ASSIGN yyn: BIN: [ret] 
.$@MSB [r13 

(The commands in the indirect file appear on the terminal.) 

3. Replace the backup magtape with a blank magtape. When MTB.COM or 
MSB.COM finishes copying files to the first magtape, it prints the following 
question on the terminal: 

xxn : /Initiallzs; Are you sure? 

Before you type a response, rewind the newly created backup magtape, remove 
it, write protect it by removing the ring, and label it "RT-11 Bootable V05.6 1/2". 

Then, mount another blank magtape, ensuring that the the write ring is in the 
back of the reel. Make sure that the tape is positioned at the load point. 

4. Copy from the disk to the blank magtape those files that were on distribution 
magtape 2. 



Type a Y I RET in response to the "Initialize; Are you sure?" question on the 
terminal. 

MTB.COM or MSB.COM initializes the blank magtape and copies a duplicate of 
distribution magtape 2. When the indirect command file finishes executing, the 
monitor prompt (.) appears on your terminal. Rewind the newly created backup 
magtape, remove it, write protect it by removing the ring, and label it "RT-11 
Bootable V05.6 2/2". 
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Store the magtapes. 

8.2.2 Using MUB.COM 

To use MUB.COM: 

1. Slide the write-protect switch on the front of a blank TK50 cartridge to the right 
to enable writing on the tape. Insert and load the blank TK50 magtape cartridge 
in the tape drive. 

2. When the TK50 magtape cartridge is loaded, invoke the indirect command 
file MUB.COM to copy the files from the disk to your blank TK50 magtape. 
MUB.COM initializes the blank TK50 magtape, writes the primary bootstrap on 
it, and copies files in their correct order from the disk to the TK50 magtape. 
Before you invoke MUB.COM, use the ASSIGN command to assign the logical 
name BIN: to your disk device and the logical name KIT: to your tape drive. In 
the following commands, yy is your disk. 

.ASSIGN MUn: KIT: [ret] 
.ASSIGN yyn: BIN: [ret] 
.$@MUB [r13 

(The commands in the indirect file appear on the terminal.) 

3. When MUB.COM finishes executing, the monitor prompt (.) appears on your 
terminal. Rewind the newly created backup TK50 magtape, remove it, write 
protect it, and label it "RT-11 Bootable V05.6 1/1". 

Store the TK50 magtape. 

8.3 Creating a Master (Distribution) Magtape 

MTB.COM, MSB.COM, and MUB.COM are procedures that let you create a bootable 
master magtape while you run RT-11 from a disk. 

Use MTB.COM if your magtape is to be written at 800 bpi. Use MSB.COM if your 
magtape is to be written at 1600 bpi. Use MUB.COM if your magtape is a TK50. 

Section 8.2.1 describes using MTB.COM and MSB.COM. Section 8.2.2 describes 
using MUB.COM. Proceed to the appropriate section to create a bootable master 
magtape. 

8.4 Creating the Working System from Chosen Components 

Once you have chosen your system components (Section 2.4), backed up the 
distribution magtapes, and created updated masters, you can create the working 
system by deleting unneeded components from the disk. 

The following command queries you about all the files on the disk. Choose the files 
you want to delete. 
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. DELETE/SYSTEM/QUERY * . * [ret] 
Files deleted: 
DK:aaaaaa.ttt? Y |ret| (deletes aaaaaa.ttt) 
DK:bbbbbb.ttt? N [Rfr] (retains bbbbbb.ttt) 

(and so on) 

8.5 Installing the Bootstrap on the Disk 

Once you have created your working system, copy the bootstrap from the monitor 
file of your choice to the disk. In the command, xx is the permanent device name for 
your disk, and aa is SB, FB, or one of the mapped monitors. 

.COPY/BOOT xxO-.RTllaa.SYS xxO : [rHI 

Then, halt the processor and use the hardware bootstrap to boot the working system 
disk. 

RT-llaa V05.XX 
(Followed by any start-up file commands.) 



NOTE 

If the disk does not boot, repeat the procedures to this 
point. 

8.6 Customizing the System 

You may want to make customizations (described in Section 2.6) to the distributed 
RT-11 components. At this point, perform the procedures to implement any of these 
software customizations. Table 1-2 summarizes the available customizations and 
directs you to the section in Chapter 2 that describes a particular customization and 
the procedure for implementing it. 

NOTE 

Later, you can perform the system generation process to 
implement additional customizations. (See Section 8.10.) 

8.7 Compressing the Disk 

Digital recommends that you compress the working system disk to make its free 
space contiguous. Consolidating free space allows you to use space on the disk that 
would otherwise be too fragmented to be usable. 

Use the SQUEEZE command for this procedure. (The disk must be write enabled.) 
The squeeze operation does not move files with the .BAD file type. In the command, 
XX is the device name for your disk. 
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. SQUEEZE xxn : |ret| 

xxn: /Squeeze; Are you sure? Y |ret| 
RT-llaa V05.XX 
(Followed by any start-up file commands.) 

The system automatically reboots when you compress a system disk. 

8.8 Preserving the Working System 

Once you build a satisfactory working system, Digital recommends that you protect 
all the files in it and preserve the system on the backup medium of your choice. 

Use the following procedures to back up the disk on magtape. First, protect all the 
files on the disk. 

. PROTECT/SYSTEM * . * [ret] 
Files protected: 
DK :aaaaaa.ttt 
DK-.bbbbbb.ttt 
DK : cccccc .ttt 
DKidddddd.ttt 



DKizzzzzz . ttt 

Next, initialize another blank magtape and copy files to it. You may be able to fit 
the working system on one backup magtape. 

Mount a blank magtape, leaving the write ring in the back of the reel. Make sure 
that the tape is positioned at the load point. If your device name is MT or MM, use 
the following command (where xx is MT or MM): 



. INITIALIZE/FJ-LE : MBOOT . BOT xxO : 

xxO : /Initialize; Are you sure? Y |ret| 

If your device name is MS, use the following command: 

. INITIALIZE/FILE :MB0T1 6. BOT MSO : [ret] 
MSO : /Initialize; Are you sure? Y |ret| 

If your device name is MU, use the following command: 

.INITIALIZE/FILE -.MBOOT. BOT MUO : [ret] 
MUO : /Initialize; Are you sure? Y |ret| 

Then, copy all the files from the disk to the magtape, in the order shown. Essentially, 
you should use the following procedure whenever you build a bootable magtape. If 
you do not copy the files in this order, bootstrapping the magtape will be a painfully 
long process. Keep track of all the files you copy, so that when you copy the rest 
of the files, you will know which files you have already copied. If you have deleted 
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some device handlers from the system, the log that prints on the terminal will not 
include the deleted device handlers. 

The following COPY procedure shows a log from a system that includes all the device 
handlers. In the commands, xx is MT, MM, MS, or MU and aa is SB, FB, or one of 
the mapped monitors: 

.COPY MSBOOT.BOT kkO :MSBOOT .BOT /POSITION :-l [ret] 

.COPY/SYSTEM MDUP . * xxO:MDUP. * /POSITION :-l [ret] 
Files copied: 
DK-.MDUP.MM to xxO:MDUP.MM 
DK-.MDUP.MT to xxO:MDUP.MT 
DK: MDUP. MS to xxO:MDUP.MS 
DK-.MDUP.MU to xxO:MDUP.MU 

.COPY SWAP. SYS xxO: SWAP. SYS /POSITION:-! [Rfr] 

.COPY RTllaa.SYS xxO :RTllaa. SYS/POSITION :-l [Rfr] 

.COPY TT.SYS xxO:TT. SYS/POSITION :-l \r^ 

. COPY/SYSTEM D* . SYS xxO : * . SYS/POSITION: -1 [retI 
Files copied: 
DK:DL.SYS to xxO:DL.SYS 
DK:DM.SYS to xxO:DM.SYS 
DK:DX.SYS to xxO:DX.SYS 



. COPY/SYSTEM R* . SYS xxO : * . SYS/POSITION: -1 [retI 
Files copied: 
DK:RK.SYS to xxO:RK.SYS 



. COPY/SYSTEM M* . SYS xxO : * . SYS/POSITION: -1 [retI 
Files copied: 
DK:MM.SYS to xxO:MM.SYS 
DK:MT.SYS to xxO:MT.SYS 
DK:MS.SYS to xxO:MS.SYS 
DK:MU.SYS to xxO:MU.SYS 



. COPY/SYSTEM L * . SYS xxO : * . SYS/POSITION: -1 [retI 
Files copied: 
DK:LS.SYS to xxO:LS.SYS 
DK:LP.SYS to xxO : LP . SYS 



COPY PIP.SAV xxO:PIP.SAV/POSITION:-l [RfT] 
COPY DUP.SAV xxO:DUP.SAV/POSITION:-l [Rfr] 
COPY DIR.SAV xxO:DIR.SAV/POSITION:-l [Rfr] 
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Copy the rest of the files. The following command queries you about all the files on 
the disk so that you can choose the files it copies. 

.COPY/SYSTEM/QUERY DK: xxO : /POSITION: -1 [ret] 
Files copied: 
DK : aaaaaa . ttt to xxO:aaaaaa.ttt? Y |ret| (includes aaaaaa.ttt) 
DK: zzzzzz .ttt to xxO : zzzzzz .ttt? N |ret| (excludes zzzzzz .ttt) 

(and so on) 

Rewind the newly created backup working system magtape, remove it, label it 
"Backup Working System RT-11 V05", and then store it. 

8.9 Testing the Working System 

Once you have built and preserved the working system, you can execute the 
following demonstration to test that system. This demonstration does not serve 
as a comprehensive system exercise; however, because it uses several major system 
components, it does serve as a minimal integrity check. Moreover, Digital considers 
your system officially installed if the demonstration runs without error. 

To execute this demonstration, your working system must include at least the 
following components: 

SWAP.SYS 

RTllFB.SYS 

XX. SYS (system device handler) 

LP.SYS (or LS.SYS) 

KED.SAV 

MACRO.SAV 

SYSMAC.SML 

LINK.SAV 

PIP.SAV 

DUP.SAV 

DIR.SAV 

DEMOBG.MAC 

DEMOFG.MAC 

Display the directory of the system volume on the terminal. The directory varies 
according to your working system. As long as a directory prints, you need not worry 
if it does not match the one in the following example. 

.DIRECTORY/BRIEF/COLUMNS : 1 SY: [retI 

dd-nmim-yy 
SWAP . SYS 
RTllFB.SYS 
LP . SYS 

DL . SYS 

MS . SYS 

KED . SAV 

MACRO .SAV 
SYSMAC.SML 
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LINK . SAV 
PIP . SAV 



XXX Files, bbb Blocks 
fff Free blocks 



NOTE 

If you have shifted output to your terminal and the 
directory scrolls by too quickly to read, press |ctrus| 
or I HOLD screen] to stop the display and |ctruq| or 
I HOLD screen] again to restart it. 

Before you can execute the background and foreground demonstration programs, 
you must first edit, assemble, and link the background program, DEMOBG.MAC, 
and you must assemble and link the foreground program, DEMOFG.MAC. 

8.9.1 Preparing the Background Demonstration Program 

8.9.1.1 Edit the Background Demonstration Program 

Use the KED text editor to modify the background demonstration program, 
DEMOBG.MAC. One of the output lines in the program is preceded by a semicolon, 
which makes the line a comment field. The semicolon prevents the line from 
being printed; thus, it must be deleted from that line. If DEMOBG.MAC 
is a protected file, you must remove the protection before making the edits 
(UNPROTECT SY:DEMOBG.MAC). The following commands and keypad strokes 
open DEMOBG.MAC for editing and remove the semicolon from the file: 



.EDIT SY: DEMOBG.MAC 


|ret| 


1 PF1 1 1 PF3 1 




Model? ; ItabI .ASCII 


1 4 1 


1 PF1 1 1 7 1 




Command? EXIT | enter | 





8.9.1.2 Assemble thie Background Demonstration Program 

The background program, DEMOBG.MAC, is an assembly language source file; it 
must be assembled and linked before you can execute it. To assemble DEMOBG.MAC 
and obtain a printed listing, first make sure that your configuration has an on-line 
printer that is ready and issue the following commands: 

.ASSIGN LS LP [ret] 
.ASSIGN LP LST 



If your configuration does not include a printer, use the console terminal: 

.ASSIGN TT LST [Rfr] 
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Next, assemble DEMOBG.MAC as follows: 

.MACRO/LIST:LST: DEMOBG \^ 

(See Figure 8-1.) 

If any errors occur when you assemble DEMOBG.MAC, you have incorrectly edited 
the file and should repeat the edits. Use the backup demonstration program. 

.RENAME SY : DEMOBG . BAK SY : DEMOBG . MAC \nM] 



Figure 8-1 : DEMOBG Assembly Listing 



DEMOBG MACRO V05.05 Sunday 13-Jan-91 13:33 Page 1 



1 
2 
3 
4 
5 
6 
7 

8 000000 

9 000034 
10 000042 
11 

12 
13 

14 000044 

15 000052 

16 000106 
17 

18 

19 

20 000110 

21 

22 000112 

23 000147 

24 000225 

25 000237 
26 

27 000240 

28 000254 
29 



. TITLE DEMOBG 

.IDENT /V05.00/ 
; DEMONSTRATION PROGRAM TO PRINT DEMONSTRATION MESSAGE, THEN 
; RING BELL IF FG JOB SENDS A MESSAGE. 

.MCALL .RCVDC, .PRINT 

START:: .RCVDC #AREA, iBUFFER, #400, #MSGIN ;POST REQUEST FOR MESSAGE 
.PRINT #MSG ; PRINT DEMONSTRATION MESSAGE 

BR ;AND LOOP 

; COMPLETION ROUTINE ENTERED WHEN FG SENDS MESSAGE 

MSGIN: .PRINT #BELL ;RING BELL IN RESPONSE TO MESSAGE 

.RCVDC iAREA, #BUFFER, #400, iMSGIN ; POST ANOTHER MESSAGE REQUEST 
RETURN ;AND RETURN FROM COMPLETION ROUTINE 

; ASCII MESSAGES 

.NLIST BEX 
.BYTE 7,200 



007 BELL: 

122 MSG: 

111 

127 

000 

AREA: 
BUFFER: 



/MESSAGE THAT RINGS BELL 



.ASCII /RT-11 DEMONSTRATION PROGRAM/<lS><12> 

.ASCII /IF INCORRECTLY EDITED, THIS IS THE LAST LINE. /<1S><12> 

.ASCII /WELL DONE./ 

. BYTE 



.BLKW 6 



;EMT ARGUMENT AREA 
; RCVDC MESSAGE AREA 



000000' 
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Symbol table 



AREA 


000240R 




MSG 


000112R 


... VI = 000003 


BELL 


OOOllOR 




MSGIN 


000044R 


. . .V2 = 000027 


BUFFER 


000254R 




START 


OOOOOORG 




. ABS. 


000000 


000 


(RW, I, 


GBL, ABS, OVR) 






000254 


001 


(RW, I, 


LCL, REL, CON) 




Errors 


detected: 












*** Assembler statistics 



Work file reads: 

Work file writes: 

Size of work file: 10912 Words 

Size of core pool: 21760 Words 

Operating system: RT-11 

Elapsed time: 00:00:06.16 
DEMOBG, DEMOBG/L : TTM=DEMOBG 



( 43 Pages) 
( 85 Pages) 
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8.9.1.3 Link the Background Demonstration Program 

Link the program DEMOBG.OBJ to produce an executable background program, 
DEMOBG.SAV. 

.LINK DEMOBG [fll] 

8.9.1.4 Run the Background Demonstration Program 

Run the program DEMOBG to check the results of the first exercise. 

.RUN DEMOBG [Rfr] 

RT-11 DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED, THIS IS THE LAST LINE. 

WELL DONE. 

If you did not delete the semicolon character, the last line will not print. Return to 
the monitor by twice pressing CTRL/C: 



If you incorrectly edited the file, you can repeat this exercise, although you can 
continue without correcting the file. However, if you want to repeat the exercise, 
begin by using the backup demonstration program. 

.RENAME SY : DEMOBG . BAK SY : DEMOBG . MAC [ret] 

Then, repeat the editing procedure. 

8.9.2 Preparing the Foreground Demonstration Program 

DEMOFG.MAC is a small foreground program that sends a message every 2 seconds 
to DEMOBG (running in the background), telling it to ring the terminal bell. 
DEMOBG recognizes these messages and rings the bell once for each message sent. 

Although DEMOFG is always active, sending messages to the background every 2 
seconds, the circuit is complete and messages are successfully received and honored 
only when DEMOBG is active. During those periods when DEMOBG is not running, 
DEMOFG enters the messages in the monitor message queue. Once you restart 
DEMOBG in the background, the system immediately releases all the messages 
queued since the last forced exit, resulting in many successive bell rings. When the 
queue is empty, the normal send/receive cycle resumes and the bell rings every 2 
seconds as each current message is sent and honored. 

To execute the foreground program, assemble the program DEMOFG.MAC, link it 
for the foreground, and execute it in conjunction with DEMOBG.SAV. 
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8.9.2.1 Assemble the Foreground Demonstration Program 

The foreground demonstration program, DEMOFG.MAC, is an assembly language 
source file; it must be assembled and linked before you can use it. Assemble 
DEMOFG.MAC as follows: 

.MACRO/LIST:LST: DEMOFG \^ 

The output resulting from this MACRO command is an object file called 
DEMOFG.OBJ. This file resides on your system volume. 

8.9.2.2 Link thie Foreground Demonstration Program 

You must link the DEMOFG.OBJ file to produce an executable program. Use the 
/FOREGROUND option to produce the load module DEMOFG.REL. The .REL file 
type signifies to the system that the file is a foreground program and is to be run as 
the priority job. 

.LINK/FOREGROUND DEMOFG \^ 

8.9.2.3 Run tlie Foreground and Bacl<ground Demonstration Programs 

Type the following command to load and start DEMOFG.REL as the foreground job. 

.FRUN DEMOFG [rIt] 

F> 

FOREGROUND DEMONSTRATION PROGRAM 

SENDS A MESSAGE TO THE BACKGROUND PROGRAM DEMOBG 

EVERY 2 SECONDS, TELLING IT TO RING THE BELL. 

I CTRL/B I 



B> 

DEMOFG.REL is now running and queuing the message for DEMOBG every 2 
seconds. Now execute DEMOBG.SAV in the background and receive the messages. 

.RUN DEMOBG [Rfr] 

(The bell rings quickly several times, then once every 2 seconds.) 

RT-11 DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED, THIS IS THE LAST LINE. 

WELL DONE. 

Execute a DIRECTORY command in the background to obtain a directory listing. 



I CTRL/C I 
I CTRL/C I 



(The bell stops ringing. ) 
.DIRECTORY [ret] 
dd-mmm-yy 
(The directory of the device DK prints on the terminal . ) 
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Rerun DEMOBG to collect all the foreground messages queued while the directory 
was printing. 

.RUN DEMOBG [ret] 

(The bell rings several times in rapid succession, then rings once every 2 seconds.) 

RT-11 DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED, THIS IS THE LAST LINE. 

WELL DONE. 



CTRL/C 



(The bell stops ringing. ) 
Now, stop the foreground program and remove it from memory. 



CTRL/F 



F> 



I CTRL/C I 
I CTRL/C I 



B> 

UNLOAD F [rHI 

If you completed these exercises without error, your system has passed this minimal 
test and you can consider it successfully installed. 

8.10 Performing the System Generation Process 

If you need RT-11 features that are available only if you generate your own 
monitor(s) and handlers, perform the system generation process at this point. You 
should have thoroughly studied Chapter 1 to make this decision and to establish 
that you can perform the system generation process on your particular hardware 
configuration. Read the RT-11 System Generation Guide for guidance in planning 
and performing system generation. 

8.11 Further Information 

After installing RT-11, read the Introduction to RT-11. The Introduction to RT-11 
provides a tutorial interactive explanation of RT-11. 
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Chapter 9 

Installing RT-11 on a Professional 300 Series 

Computer 

If you are installing RT-11 to run on a Professional 300 series computer, perform 
the procedures described in this chapter. 

You will have received the RT-11 operating system on RX50 diskettes, and will be 
installing it to run on a nonremovable disk. 

Your distribution kit contains two copies of the RT-11 operating system on RX50 
diskettes. Store one set of the RX50 diskettes in a safe place and do not modify their 
contents. They provide a master copy of the distributed RT-11 operating system. 

Store the second set of diskettes in a safe place after installing software updates 
and copying their contents onto the nonremoveable disk. The second set provides 
a backup copy of your updated RT-11 system. Use those diskettes, if it is ever 
necessary, to create another working system. If those diskettes are ever damaged, 
use the master copy of the distributed RT-11 operating system to reproduce them. 

To install your system, perform the steps listed below and described in Sections 9.1 
through 9.10. 

1. Bootstrap the system diskette. 

2. Copy the system diskette onto the system disk. 

3. Install the bootstrap on the system disk. 

4. Copy the distribution diskettes onto the system disk. 

5. Create the working system from chosen components. 

6. Customize the system. 

7. Compress the system disk. 

8. Preserve the working system. 

9. Test the working system. 

10. If appropriate, perform the system generation procedures. 

11. Read the Introduction to RT-11 for more information on using RT-11. 
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9.1 Bootstrapping the System Diskette 

The first procedure you perforin when instalhng RT-11 bootstraps the system 
diskette. 

First, turn off the processor (press the power switch to 0). 

In the software distribution, the highest numbered diskette is bootable on 
Professional 300 series computers. Remove that diskette from the kit, make sure it 
is write protected (with a write-protect tape over the notch), and insert it in diskette 
Unit (which has the physical device name DZO:). Unit is the top slot if your 
computer sits horizontally on a table top, or the left slot if it sits vertically in a floor 
stand. 

Turn on the processor (perform a hard boot) by pressing the power switch to 1 (on). 
Wait while the system runs diagnostic tests. If there are no problems, the Digital 
logo appears on the screen in about 30 seconds. 

If a problem occurs, a diagram of the computer appears on your screen. If the 
problem is in the hardware, the part of the computer that has a problem is 
highlighted in the diagram. Write down the numbers you see on the screen. 

If the top number is 051124, refer to Chapter 7 of the RT-11 System Message Manual. 

If the top number is 010030 followed underneath by 000401, you have an 
unformatted hard disk. Software cannot be installed on the hard disk. After 
displaying the diagnostic picture, the RT-11 system boots from the diskette. Execute 
the following sequence of commands to format and install the hard disk: 

.FORMAT DW: [ret] 

.INSTALL DW: [ret] 

.LOAD DW: [ret] 

. FORMAT/VERIFY : ONLY DW: \^ 

The command FORMAT DW: generates the informational message ?FORMAT-I- 
Install DW. Attempting to verify a hard disk with FORMATA^RIFY or FORMAT 
A/ERIFY:ONUY' before formatting an unformatted hard disk generates the error 
message ?FORMAT-F -Invalid device for I VERIFY, or not formatted. 

If your screen shows a number other than those discussed in the preceding 
paragraphs, refer to your computer Owner's Manual. 

If nothing happens when you turn the power on, refer to the computer Owner's 
Manual for help. 

RT-11 should respond with the following message if you have successfully 
bootstrapped the diskette: 

RT-llXM V05.XX 
.TYPE V5USER.TXT 

RT-11 V5.XX 
Installation of RT-11. . . . (followed by V5USER.TXT message) .... 
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9.2 Copying the System Diskette onto the System Disk 

Once you have installed software updates, copy the system diskette onto the 
nonremovable disk. 

You must first use the INITIALIZE command to initialize the nonremovable disk. 
Use the /BADBLOCKS option with INITIALIZE to cover any bad blocks that may 
be on your disk (this prevents the system from trying to use them). If the disk 
contains bad blocks, the ?DUP-W-Bad blocks detected nnnnnn message appears on 
the terminal. 



. INITIALIZE/BADBLOCKS DWO : 

DWO: /Initialize; Are you sure? Y |ret| 

?DUP-I-No bad blocks detected DWO: 

The system scans the disk for bad blocks and creates a new directory. The monitor 
dot ( . ) appears when this process is complete. 

Then, copy the contents of the system diskette onto the disk. 

. COPY/SYSTEM DZO : DWO : [Rfr] 



9.3 Installing the Bootstrap on the System Disk 

Once you have copied the contents of the system diskette onto the system disk, you 
need to install the bootstrap on the system disk. 

.COPY/BOOT DWO-.RTllXM.SYS DWO: [retI 

This command copies bootstrap information from the monitor file to blocks and 2 
through 5 of the same volume. 

Remove the system diskette from Unit 0. Turn the computer off ( ) and then on 
( 1 ) to hard boot the system disk. RT-11 responds with the following message if you 
have successfully bootstrapped the system disk: 

RT-llXM V05.XX 
(Followed by any start-up file commands.) 



9.4 Copying the Distribution Diskettes onto the System Disk 

The next operation you perform copies the remaining distribution diskettes onto the 
system disk. 

Insert distribution diskette 1 in Unit 0. Distribution diskette 1 contains some files 
that are duplicates of files on the diskette you first copied to the hard disk. Because 
the original files are protected, the copy operation does not copy the duplicates. Now, 
copy all nonduplicate files to the system disk by typing the command: 

. COPY/SYSTEM DZO : DWO : [ret] 
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Remove that distribution diskette from Unit and store it. Then, repeat this 
procedure to copy the remaining distribution diskettes onto the system disk. When 
you have completed copying all distribution diskettes, store them in a safe place. 

9.5 Creating the Working System from Chosen Components 

Once you have chosen your system components (see Section 2.4), you can create the 
working system by deleting selected files from your system disk. You can delete 
unwanted files automatically or manually. 

To delete unwanted files automatically, run the CONFIG file as follows and obey the 
prompts: 

.$@ CONFIG [rIi] 

You can manually delete unwanted files by using the following command. RT-11 
queries you about all the files on the disk, and you choose the files it deletes. 

.DELETE/SYSTEM/QUERY DWO : [rIt] 

Files deleted: 
DWO : aaaaaa . ttt Y |ret| (deletes aaaaaa.ttt) 

DWO:bbbbbb.ttt N [Rfr] (retains bbbbbb.ttt) 

(and so on) 

Repeat this procedure to retain only the files you planned for the working system 
disk. 

9.6 Customizing the System 

You may want to make customizations (described in Section 2.6) to the distributed 
RT-11 components. At this point, perform the procedures to implement any software 
customizations. Table 1-2 summarizes the available customizations and directs 
you to the section in Chapter 2 that describes a particular customization and the 
procedure for implementing it. 

NOTE 

Later, you can perform the system generation process to 
implement additional customizations. 

9.7 Compressing the System Disk 

Digital recommends that you compress the working system disk to make its free 
space contiguous. Consolidating free space lets you use space on the disk that would 
otherwise be too fragmented to be usable. 

If you used CONFIG to remove unwanted files, your system disk was squeezed by 
CONFIG. If you removed unwanted files manually, use the SQUEEZE command to 
compress free space. (The volume must be write enabled.) 

.SQUEEZE DWO: [ret] 

DWO: /Squeeze; Are you sure? Y |ret| 

RT-llxx V05.XX 
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The system automatically reboots when you compress a system disk. 

9.8 Preserving the Working System 

Once you build a satisfactory working system, Digital recommends that you preserve 
all the system files on backup diskettes. 

Insert a blank RX50 diskette in diskette Unit or 1 so you can initialize it. You 
can use the INITIALIZE command with the /BADBLOCKS option to initialize the 
diskette and to detect any bad blocks that may be on it. If the diskette contains bad 
blocks, the ?DUP-W-Bad blocks detected nnnnnn message appears on the terminal. 
In the command, n is the device unit number. 

Digital recommends that you use only diskettes that have no bad blocks. To 
ascertain whether an already initialized diskette has bad blocks, use the command 
DIRECTORY/BAD DZn: where n is the drive number. You can use diskettes with 
bad blocks later for temporary storage or as work volumes. 



. INITIALIZE/BADBLOCKS DZn : 

DZn: /Initialize; Are you sure? Y |ret| 

?DUP-I-No bad blocks detected DZn: 

There will be a delay while the system scans the diskette for bad blocks and creates 
a new directory. The monitor dot ( . ) appears when this process is complete. 

Now, remove the newly initialized diskette and initialize an adequate number of 
blank diskettes, leaving one initialized, blank, write-enabled (write-protect notch 
uncovered) diskette inserted in Unit or 1. 

Copy all the files in your working system, using the COPY/MULTIVOLUME 
command below. In the command, n is the device unit number. The system copies 
all the files from the disk (the input volume) that will fit on the diskette (the output 
volume). When no more files will fit on the diskette, the system prompts you to 
mount another output volume and prints the Continue? message. 

Mount another blank, initialized diskette, and type Y to continue. Continue to mount 
diskettes in this fashion until all the files are copied. 

. COPY/MULTIVOLUME/SYSTEM DWO : DZn : [ret] 

Files copied: 
DWO : aaaaaa . ttt to DZn : aaaaaa . ttt 
DWO:bbbbbb.ttt to DZn : bbbbbb . ttt 

(and so on) 

Mount next output volume in DZn:; Continue? Y |ret| 

(Log of files copied) 
Mount next output volume in DZn:; Continue? Y |ret| 

(Log of files copied) 

(and so on) 

Remove each diskette from Unit or 1 and label it "Backup RT-11 V05 x" (where x 
is the diskette number). Use a soft-tipped pen when you label diskettes. Then, store 
them in a safe place. 
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To restore the working system, you can copy the backup working system diskettes 
toDW. 

Any backed-up working system diskette you intend to be bootable must contain 
certain system utihty programs. For example, the highest numbered distribution 
diskette is bootable, but the rest of the diskettes in your kit are not bootable because 
they lack the necessary components. A bootable diskette needs an appropriate 
monitor file, a bootstrap, a system device handler, the SWAP.SYS file, and the 
interface device handler PIX.SYS. 

Then, install the bootstrap on any backup working system diskettes that contain the 
necessary programs and need to be bootable. 

.COPY /BOOT DZn:RTllXM DZn : 



9.9 Testing the Working System 

Once you have built and preserved the working system, you can execute the 
following demonstration to test that system. This demonstration does not serve 
as a comprehensive system exercise; however, because it uses several major system 
components, it does serve as a minimal integrity check. Moreover, Digital considers 
your system officially installed if the demonstration runs without error. 

To execute this demonstration, your working system must include at least the 
following components: 

SWAP.SYS 

RTllXM.SYS 

PIX.SYS 

DWX.SYS (system device handler) 

DZX.SYS 

LSX.SYS 

KEX.SAV 

MACRO.SAV 

SYSMAC.SML 

LINK.SAV 

PIPSAV 

DUPSAV 

DIR.SAV 

DEMOBG.MAC 

DEMOFG.MAC 

Display the directory of the system volume on the terminal. The directory varies 
according to your particular working system. As long as a directory prints, you need 
not worry if it does not match the one in the following example. 
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.DIRECTORY/BRIEF/COLUMNS:! SY: [ret] 

dd-nmim-yy 
SWAP . SYS 
RTllXM.SYS 
PIX . SYS 
LSX . SYS 
DZX . SYS 
DWX . SYS 
KEX . SAV 
MACRO .SAV 
SYSMAC.SML 
LINK . SAV 
PIP . SAV 



XXX Files, bbb Blocks 
fff Free blocks 



NOTE 

If you have shifted output to your terminal and the 
directory scrolls by too quickly to read, press |ctrus| 
or I HOLD screen] to stop the display and |ctruq| or 
I HOLD screen] again to restart it. 

Before you can execute the background and foreground demonstration programs, 
you must first edit, assemble, and link the background program, DEMOBG.MAC, 
and you must assemble and link the foreground program, DEMOFG.MAC. 

9.9.1 Preparing the Background Demonstration Program 

9.9.1.1 Edit the Background Demonstration Program 

Use the keypad text editor to modify the background demonstration program, 
DEMOBG.MAC. One of the output lines in the program is preceded by a semicolon, 
which makes the line a comment field. The semicolon prevents the line from 
being printed; thus, it must be deleted from that line. If DEMOBG.MAC 
is a protected file, you must remove the protection before making the edits 
(UNPROTECT SY:DEMOBG.MAC). The following commands and keypad strokes 
open DEMOBG.MAC for editing and remove the semicolon from the file: 



.EDIT SY: DEMOBG.MAC 

1 PF1 1 1 PF3 1 


|ret| 


Model? ; ItabI .ASCII 


1 4 1 


1 PF1 1 1 7 1 




Command? EXIT | enter] 
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9.9.1.2 Assemble the Background Demonstration Program 

The background program, DEMOBG.MAC, is an assembly language source file; it 
must be assembled and linked before you can execute it. To assemble DEMOBG.MAC 
and obtain a printed listing, first make sure that your configuration has an on-line 
printer that is ready and issue the following commands: 

.ASSIGN LS LP [ret] 
.ASSIGN LP LST [Rfr] 

If your configuration does not include a printer, use the console terminal: 

.ASSIGN TT LST [Rfr] 

Next, assemble DEMOBG.MAC as follows: 

.MACRO/LIST: LST: DEMOBG \^ 

(See Figure 9-1.) 

If any errors occur when you assemble DEMOBG.MAC, you have incorrectly edited 
the file and should repeat the edits. Use the backup demonstration program. 

.RENAME SY: DEMOBG. BAK SY : DEMOBG . MAC \^] 

9.9.1.3 Link thie Background Demonstration Program 

Link the program DEMOBG. OBJ to produce an executable background program, 
DEMOBG.SAV. 

.LINK DEMOBG \^\ 

9.9.1.4 Run thie Background Demonstration Program 

Run the program DEMOBG to check the results of the first exercise. 

.RUN DEMOBG \^] 

RT-11 DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED, THIS IS THE LAST LINE. 

WELL DONE. 

If you did not delete the semicolon character, the last line will not print. Return to 
the monitor by twice pressing CTRL/C: 



I CTRL/C I 
I CTRL/C I 



If you incorrectly edited the file, you can repeat this exercise, although you can 
continue without correcting the file. However, if you want to repeat the exercise, 
begin by using the backup demonstration program. 

.RENAME SY : DEMOBG . BAK SY : DEMOBG . MAC \^ 
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Figure 9-1 : DEMOBG Assembly Listing 

DEMOBG MACRO V05.0S Sunday 13-Jan-91 13:33 Page 1 

1 . TITLE DEMOBG 

2 .IDENT /V05.00/ 

3 ; DEMONSTRATION PROGRAM TO PRINT DEMONSTRATION MESSAGE, THEN 

4 ; RING BELL IF FG JOB SENDS A MESSAGE. 
5 

6 .MCALL .RCVDC, .PRINT 

7 

8 000000 START:: .RCVDC iAREA, iBUFFER, #400, #MSGIN ;POST REQUEST FOR MESSAGE 

9 000034 .PRINT #MSG ; PRINT DEMONSTRATION MESSAGE 
10 000042 000777 BR ; AND LOOP 

11 

12 ; COMPLETION ROUTINE ENTERED WHEN FG SENDS MESSAGE 

13 

14 000044 MSGIN: .PRINT iBELL ;RING BELL IN RESPONSE TO MESSAGE 

15 000052 .RCVDC #AREA, iBUFFER, #400, #MSGIN ; POST ANOTHER MESSAGE REQUEST 

16 000106 000207 RETURN ; AND RETURN FROM COMPLETION ROUTINE 
17 

18 ; ASCII MESSAGES 

19 .NLIST BEX 

20 000110 007 BELL: .BYTE 7,200 ;MESSAGE THAT RINGS BELL 
21 

22 000112 122 MSG: .ASCII /RT-11 DEMONSTRATION PROGRAM/<lS><12> 

23 000147 111 .ASCII /IF INCORRECTLY EDITED, THIS IS THE LAST LINE. /<1S><12> 

24 000225 127 .ASCII /WELL DONE./ 

25 000237 000 .BYTE 
26 

27 000240 AREA: .BLKW 6 ;EMT ARGUMENT AREA 

28 000254 BUFFER: ;RCVDC MESSAGE AREA 

29 000000' .END START 
DEMOBG MACRO V05 . 05 Sunday 13-Jan-91 13:33 Page 1-1 
Symbol table 

AREA 000240R MSG 000112R . . .VI = 000003 

BELL OOOllOR MSGIN 000044R . . .V2 = 000027 

BUFFER 000254R START OOOOOORG 

. ABS. 000000 000 (RW, I, GBL,ABS, OVR) 

000254 001 (RW,I,LCL,REL,CON) 

Errors detected: 

*** Assembler statistics 

Work file reads: 

Work file writes: 

Size of work file: 10912 Words ( 43 Pages) 

Size of core pool: 21760 Words ( 85 Pages) 

Operating system: RT-11 

Elapsed time: 00:00:06.16 
DEMOBG, DEMOBG/L : TTM=DEMOBG 

Then, repeat the editing procedure. 

9.9.2 Preparing the Foreground Demonstration Program 

DEMOFG.MAC is a small foreground program that sends a message every 2 seconds 
to DEMOBG (running in the background), telling it to ring the terminal bell. 
DEMOBG recognizes these messages and rings the bell once for each message sent. 

Although DEMOFG is always active, sending messages to the background every 2 
seconds, the circuit is complete and messages are successfully received and honored 
only when DEMOBG is active. During those periods when DEMOBG is not running, 
DEMOFG enters the messages in the monitor message queue. Once you restart 
DEMOBG in the background, the system immediately releases all the messages 
queued since the last forced exit, resulting in many successive bell rings. When the 
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queue is empty, the normal send/receive cycle resumes and the bell rings every 2 
seconds as each current message is sent and honored. 

To execute the foreground program, assemble the program DEMOFG.MAC, link it 
for the foreground, and execute it in conjunction with DEMOBG.SAV. 

9.9.2.1 Assemble the Foreground Demonstration Program 

The foreground demonstration program, DEMOFG.MAC, is an assembly language 
source file; it must be assembled and linked before you can use it. Assemble 
DEMOFG.MAC as follows: 

.MACRO/LIST:LST: DEMOFG \^ 

The output resulting from this MACRO command is an object file called 
DEMOFG.OBJ. This file resides on your system volume. 

9.9.2.2 Link thie Foreground Demonstration Program 

You must link the DEMOFG.OBJ file to produce an executable program. Use the 
/FOREGROUND option to produce the load module DEMOFG.REL. The .REL file 
type signifies to the system that the file is a foreground program and is to be run as 
the priority job. 

.LINK/FOREGROUND DEMOFG \^ 

9.9.2.3 Run thie Foreground and Bacl<ground Demonstration Programs 

Type the following command to load and start DEMOFG.REL as the foreground job. 

.FRUN DEMOFG [ret] 

F> 

FOREGROUND DEMONSTRATION PROGRAM 

SENDS A MESSAGE TO THE BACKGROUND PROGRAM DEMOBG 

EVERY 2 SECONDS, TELLING IT TO RING THE BELL. 

I CTRL/B I 



B> 

DEMOFG.REL is now running and queuing the message for DEMOBG every 2 
seconds. Now execute DEMOBG.SAV in the background and receive the messages. 

.RUN DEMOBG [Rfr] 

(The bell rings quickly several times, then once every 2 seconds.) 

RT-11 DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED, THIS IS THE LAST LINE. 

WELL DONE. 

Execute a DIRECTORY command in the background to obtain a directory listing. 
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I CTRL/C I 
I CTRL/C I 

(The bell stops ringing. ) 
.DIRECTORY [ret] 
dd-mmm-yy 
(The directory of the device DK prints on the terminal . ) 

Rerun DEMOBG to collect all the foreground messages queued while the directory 
was printing. 

.RUN DEMOBG [rIi] 

(The bell rings several times in rapid succession, then rings once every 2 seconds.) 

RT-11 DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED, THIS IS THE LAST LINE. 

WELL DONE. 



CTRL/C 



(The bell stops ringing. ) 
Now, stop the foreground program and remove it from memory. 



F> 



CTRL/C 



B> 

UNLOAD F [rHI 

If you completed these exercises without error, your system has passed this minimal 
test and you can consider it successfully installed. 

9.10 Performing the System Generation Process 

If you need RT-11 features that are available only if you generate your own 
monitor(s) and handlers, perform the system generation process at this point. You 
should have thoroughly studied Chapter 1 to make this decision and to establish 
that you can perform the system generation process on your particular hardware 
configuration. Read the RT-11 System Generation Guide for guidance in planning 
and performing system generation. 

9.11 Further Information 

After installing RT-11, read the Introduction to RT-11. The Introduction to RT-11 
provides a tutorial interactive explanation of RT-11. 
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Appendix A 

Modifying IVIDUP to Recognize a Device l-landler 

The Version 5 MDUP.MM, MDUP.MS, MDUP.MT, and MDUP.MU programs support 
the following devices: 

All MSCP (DU) devices 

RK05/RK06 

RL01/RL02 

Virtual Memory (VM) device 

If you need to create MDUP for a disk or magtape not supported by RT-11 (or for 
which you have written your own handler), use MDUPSAV as follows. 

Use the SYSGEN procedure to create a hardware version of the magtape handler — 
that is, a version of the handler that does not include the FSM. 

Your configuration must include at least 28K words of memory. Apply the 
following customization to the distributed magtape (RTllMT.SYS) monitor. In the 
customization, xx is the name of the device on which the monitor resides. 



.R SIPP |ret| 










*xxn:RTllMT. 


SYS |ret| 






Base? 


|ret| 






Offset? 1122 


|ret| 






Base 




Offset 


Old 


New? 


000000 




001122 


000405 


240 |ret| 


000000 




001124 


013704 


12704 |RET| 


000000 




001126 


177570 


74000 |ret| 


000000 




001130 


xxxxxx 


1 CTRL/Y 1 1 RET | 


* |CTRL/C| 





Then, copy the bootstrap: 

.COPY/BOOT xxn: RTllMT.SYS xxn: [retI 

This procedure causes the system to use only 15K words of memory when booted. 

Next, apply the following customization to every handler to be supported by the 
version of MDUP you are building. In the customization, xx is the name of the 
device on which the handler resides, andyy is the name of the handler. 

.R SIPP [ret] 
*xxn : yy . SYS |ret| 

Base? I RET I 

Offset? 176 \^\ 
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Base Offset Old New? 

000000 000176 xxxxxx |ret| 

000000 000200 xxxxxx |ret| 

000000 000202 xxxxxx I ctrl/y | ret| 



* I CTRL/C I 

Now boot the monitor you have modified. Set the USR NOSWAP. Load all the 
handlers to be supported. Run MDUP.SAV and issue the following command. In the 
command, xx is the physical device name, and filnam.typ is your version of MDUP 
(MDUP??). 

.R MDUP.SAV [ret] 

*xx : filnam . typ=/H |ret| 

MDUP.SAV creates the file filnam.typ and exits. 



If you make a typing error in the command line, use |CTRL/c| to abort MDUP.SAV 
and run MDUP.SAV again. If you get an insufficient memory error message, you 
cannot build MDUP with all the handlers loaded. Unload one of the handlers and 
run MDUP.SAV again. 
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Appendix B 

Loading Software Bootstraps 



If your hardware configuration procedure does not include a hardware bootstrap, use 
one of the following procedures for loading a software bootstrap. Find the section 
for bootstrapping your device, and use the switch register to deposit the bootstrap 
in memory. If your hardware configuration includes a pushbutton console emulator 
instead of a switch register, follow the instructions in your hardware manual to load 
the appropriate bootstrap loader (listed in Tables B-1 through B-10). 

B.1 Loading the TMSCP Bootstrap 

If your processor does not contain the correct MU boot ROM and you want to boot 
your processor from a bootable TK50 magtape, you must manually load the TMSCP 
software bootstrap. You can load the TMSCP software bootstrap, using MICRO- 
ODT, or the console switch register if your processor has a console switch register. 
You can boot RT-11 only from TK50 controller unit 0, and you must install that unit 
at CSR address 774500 and vector address 260. 

B.1.1 Loading the TMSCP Bootstrap, Using MICRO-ODT 

Deposit the TMSCP bootstrap loader in memory as follows: 

1. Place the bootable TK50 magtape in drive unit and power up the drive. 

2. Turn on your processor. If it is already on, halt it. 

3. At the console, type the first address in Table B-1 (76026) followed by a slash (/): 
76026/ 

The system responds by printing the contents of address 76026 (represented 
below by xxxxxx) on the console: 

76026/ xxxxxx 

4. On the same line, type the first contents value in Table B-1 (5000) followed by 
a line feed: 

76026/ xxxxxx 5000 [lf] 

The system deposits the value you just typed (5000) and displays the next 
memory location: 

76030/ 

5. Type the contents of the next memory location followed by a line feed. 

6. Repeat step 5 until you have deposited all the contents. Then press RETURN. 
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7. Finally, enable the processor (remove the halt condition) and type: 
76026G 

The processor reads the software bootstrap from the magtape into memory. The 
system prints the following prompt when it is finished: 

MSBOOT V05 . Ox 
* 

If the system does not print the MSBOOT prompt after you type 76026G, you 
probably made an error in entering the bootstrap loader. Open and examine each 
location, using MICRO-ODT, and correct the error. 

8. Promptly respond to the asterisk (*) by typing MDUP.MU: 
*MDUP.MU [rIi] 

9. Follow the instructions in Chapter 8. 

B.1.2 Loading the TMSCP Bootstrap, Using the Switch Register 

Deposit the TMSCP bootstrap loader in memory as follows: 

1. Place the bootable TK50 magtape in drive unit and power up the drive. 

2. Set the ENABLE/HALT switch on the processor to HALT. 

3. Set the first address in Table B-1 (076026) in the switch register. 

4. Press the LOAD ADDR switch. 

5. Set the contents for the first address in Table B-1 (5000) in the switch register. 

6. Lift the DEP switch. The processor automatically advances to the next address. 

7. Set the contents for the next address in Table B-1 in the switch register. 

8. Lift the DEP switch. 

9. Repeat steps 7 and 8 until you have deposited all the instructions. 
Now, verify that you properly deposited the bootstrap loader. 

1. Set the starting address, 076026, in the switch register. 

2. Press the LOAD ADDR switch. 

3. Press the EXAM switch to display the contents of that address in the data 
register. 

4. Compare the value in the data register with the contents value for that address 
in Table B-1. 

5. If the values are the same, press EXAM again to display the contents of the next 
address. If the values are not the same, correct the contents value and lift the 
DEP switch. Press EXAM again to display the contents. Verify the contents of 
all addresses in this way. 
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Once you have correctly deposited the bootstrap in memory, start the computer as 
follows: 

1. Set the starting address, 076026, in the switch register. 

2. Press the LOAD ADDR switch. 

3. Set the ENABLE/HALT switch to ENABLE. 

4. Press the START switch. 

The processor reads the software bootstrap from the magtape into memory. The 
system prints the following prompt when it is finished: 

MSBOOT V05 . Ox 
* 

If the system does not print the MSBOOT prompt after you press the START 
switch, you probably made an error in entering the bootstrap loader. Repeat the 
procedure. 

5. Promptly respond to the asterisk (*) by typing MDUP.MU: 
*MDUP.MU [rIi] 

6. Follow the instructions in Chapter 8. 

B.1.3 Addresses and Contents of the TMSCP Bootstrap Loader 

The following are the addresses and contents of the TMSCP bootstrap loader: 

Table B-1 : TMSCP Bootstrap Loader 



Address 



Contents 



076026 


005000 


076030 


012701 


076032 


174500 


076034 


012704 


076036 


076160 


076040 


012705 


076042 


004000 


076044 


010102 


076046 


012422 


076050 


005712 


076052 


100770 


076054 


031205 


076056 


001774 


076060 


012412 


076062 


006305 


076064 


100371 


076066 


010502 


076070 


005022 


076072 


105702 
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Table B-1 (Cont.): TMSCP Bootstrap Loader 



Address 



Contents 



076074 


100375 


076076 


105237 


076100 


100077 


076102 


105237 


076104 


100075 


076106 


010037 


076110 


100104 


076112 


112437 


076114 


100115 


076116 


112437 


076120 


100110 


076122 


010522 


076124 


010522 


076126 


012722 


076130 


100100 


076132 


010512 


076134 


024242 


076136 


005711 


076140 


005712 


076142 


100776 


076144 


005737 


076146 


100012 


076150 


001331 


076152 


105704 


076154 


100344 


076156 


005007 


076160 


046525 


076162 


100000 


076164 


100200 


076166 


000000 


076170 


000001 


076172 


004400 


076174 


020476 


076176 


020402 



B.2 Loading the MSCP Bootstrap 

You can load the MSCP software bootstrap, using MICRO-ODT or the console switch 
register if your processor has a console switch register. 

B.2.1 Loading the MSCP Bootstrap, Using MICRO-ODT 

Deposit the MSCP bootstrap loader in memory as follows: 

1. Place the bootable MSCP volume in physical unit DUO: (the unit installed at DU 
CSRO) and power up the drive. 

2. Turn on your processor. If it is already on, halt it. 
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3. At the console, type the first address in Table B-2 (76000) followed by a slash (/): 
76000/ 

The system responds by printing the contents of address 76000 (represented 
below by xxxxxx) on the console: 

76000/ xxxxxx 

4. On the same line, type the first contents value in Table B-2 (5000) followed by 
a line feed: 

76000/ xxxxxx 5000 [If] 

The system deposits the value you just typed (5000) and displays the next 
memory location: 

7^002/ 

5. Type the contents of the next memory location followed by a line feed. 

6. Repeat step 5 until you have deposited all the contents. Then, press RETURN. 

7. Finally, enable the processor (remove the halt condition) and type: 
76000G 

The processor reads the software bootstrap from the MSCP volume into memory. 
When it is finished, the system prints an RT-11 monitor identification message 
such as the following: 

RTllFB VOS.Ox 

If the system does not print an RT-11 monitor identification after you type 
76000G, you probably made an error in entering the bootstrap loader. Open 
and examine each location, using MICRO-ODT and correct the error. 

B.2.2 Loading the MSCP Bootstrap, Using the Switch Register 

Deposit the MSCP bootstrap loader in memory as follows: 

1. Place the bootable MSCP volume in physical unit DUO: (the unit installed at DU 
CSRO) and power up the drive. 

2. Set the ENABLE/HALT switch on the processor to HALT. 

3. Set the first address from Table B-2 (076000) in the switch register. 

4. Press the LOAD ADDR switch. 

5. Set the contents for the first address in Table B-2 (005000) in the switch register. 

6. Lift the DEP switch. The processor automatically advances to the next address. 

7. Set the contents for the next address in Table B-2 in the switch register. 

8. Lift the DEP switch. 

9. Repeat steps 7 and 8 until you have deposited all the instructions. 
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Now, verify that you properly deposited the bootstrap loader. 

1. Set the starting address, 076000, in the switch register. 

2. Press the LOAD ADDR switch. 

3. Press the EXAM switch to display the contents of that address in the data 
register. 

4. Compare the value in the data register with the contents value for that address 
in Table B-2. 

5. If the values are the same, press EXAM again to display the contents of the next 
address. If the values are not the same, correct the contents value and lift the 
DEP switch. Press EXAM again to display the contents. Verify the contents of 
all addresses in this way. 

Once you have correctly deposited the bootstrap in memory, start the computer as 
follows: 

1. Set the starting address, 076000, in the switch register. 

2. Press the LOAD ADDR switch. 

3. Set the ENABLE/HALT switch to ENABLE. 

4. Press the START switch. 

The processor reads the software bootstrap from the MSCP volume into memory. 
When it is finished, the system prints an RT-11 monitor identification message 
such as the following: 

RTllFB V05. Ox 

If the system does not print an RT-11 monitor identification after you press the 
START switch, you probably made an error in entering the bootstrap loader. 
Repeat the procedure. 

B.2.3 Addresses and Contents of the MSCP Bootstrap Loader 

The following are the addresses and contents of the MSCP bootstrap loader: 

Table B-2: MSCP Bootstrap Loader 
Address Contents 



76000 


005000 


76002 


012701 


76004 


172150 


76006 


012704 


76010 


076156 


76012 


012705 


76014 


004000 


76016 


010102 


76020 


010022 
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Table B-2 (Cont.): MSCP Bootstrap Loader 



Address 



Contents 



76022 


005712 


76024 


100770 


76026 


031205 


76030 


000401 


76032 


042125 


76034 


001772 


76036 


014412 


76040 


006305 


76042 


100367 


76044 


105744 


76046 


001002 


76050 


010704 


76052 


005007 


76054 


005002 


76056 


005022 


76060 


020227 


76062 


017204 


76064 


103774 


76066 


105237 


76070 


017101 


76072 


010037 


76074 


017110 


76076 


111437 


76100 


017114 


76104 


017121 


76106 


012722 


76110 


017004 


76112 


010522 


76114 


012722 


76116 


017104 


76120 


010512 


76122 


024242 


76124 


005711 


76126 


005712 


76130 


100776 


76132 


005737 


76134 


017016 


76136 


001742 


76140 


000000 


76142 


020402 


76144 


004400 


76146 


000001 


76150 


000000 


76152 


017204 


76154 


100000 
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B.3 Loading the RK11 (RK05) DECpack Bootstrap 

Deposit the basic RKll (RK05) disk bootstrap loader in memory as follows: 

1. Set the ENABLE/HALT switch to HALT. 

2. Set the first address, 001000, in the switch register (see Table B-3). 

3. Press the LOAD ADDR switch. 

4. Set the contents for the first address (in Table B-3) in the switch register. 

5. Lift the DEP switch. The computer automatically advances to the next address. 

6. Set the contents for the next address (in Table B-3) in the switch register. 

7. Lift the DEP switch. 

8. Repeat steps 6 and 7 until you have deposited all the instructions. 

Table B-3: RK11 (RK05) Bootstrap Loader 

Address Contents 



001000 


012700 


001002 


177406 


001004 


012710 


001006 


177400 


001010 


012740 


001012 


000005 


001014 


105710 


001016 


100376 


001020 


005007 



Now, verify that you deposited the bootstrap loader properly. 

1. Set the first address, 001000, in the switch register. 

2. Press the LOAD ADDR switch. 

3. Press the EXAM switch to display the contents of that address in the data 
register. 

4. Compare the value in the data register with the value for that address in 
Table B-3. 

5. If the values are the same, press EXAM again to display the contents of the 
next address. If the values are not the same, repeat the entire procedure for 
depositing the bootstrap. Verify the contents of all the addresses in this way. If 
any instruction is incorrect, repeat the entire deposit procedure. 

Once you have correctly deposited the bootstrap in memory, start the computer as 
follows: 

1. Set the starting address, 001000, in the switch register. 
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2. Press the LOAD ADDR switch. 

3. Set the ENABLE/HALT switch to ENABLE. 

4. Press the START switch. 

B.4 Loading the RX11 Bootstrap 

The procedure to deposit the RXll disk bootstrap loader in memory depends on the 
type of processor you have. If your computer is a PDP-llV/03, PDP-11/03, or LSI- 
11, see the PDP-11 1 03 User's Manual for instructions. Otherwise deposit the RXll 
disk bootstrap loader in memory as follows: 

1. Set the ENABLE/HALT switch to HALT. 

2. Set the first address, 001000, in the switch register (see Table B-4). 

3. Press the LOAD ADDR switch. 

4. Set the contents for the first address (from Table B-4) in the switch register. 

5. Lift the DEP switch. The computer automatically advances to the next address. 

6. Set the contents for the next address (from Table B-4) in the switch register. 

7. Lift the DEP switch. 

8. Repeat steps 6 and 7 until you have deposited all the instructions. 

Table B-4: RX11 Bootstrap Loader 
Address Contents 



001000 


005000 


001002 


012701 


001004 


177170 


001006 


105711 


001010 


001776 


001012 


012711 


001014 


000003 


001016 


005711 


001020 


001776 


001022 


100405 


001024 


105711 


001026 


100004 


001030 


116120 


001032 


000002 


001034 


000770 


001036 


000000 


001040 


005000 


001042 


000110 



Now, verify that you deposited the bootstrap loader properly. 
1. Set the first address, 001000, in the switch register. 
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2. Press the LOAD ADDR switch. 

3. Press the EXAM switch to display the contents of that address in the data 
register. 

4. Compare the value in the data register with the value for that address in 
Table B-4. 

5. If the values are the same, press EXAM again to display the contents of the 
next address. If the values are not the same, repeat the entire procedure for 
depositing the bootstrap. Verify the contents of all the addresses in this way. If 
any instruction is incorrect, repeat the entire deposit procedure. 

Once you have correctly deposited the bootstrap in memory, start the computer as 
follows: 

1. Set the starting address, 001000, in the switch register. 

2. Press the LOAD ADDR switch. 

3. Set the ENABLE/HALT switch to ENABLE. 

4. Press the START switch. 

B.5 Loading the TJU16 or TM11 Magtape Bootstrap 

Deposit the basic TJU16 or TMll magtape bootstrap loader in memory as follows: 

1. Set the ENABLE/HALT switch to HALT. 

2. Set the first address, 001000 or 010000, in the switch register (see Table B-5 or 
B-6). 

3. Press the LOAD ADDR switch. 

4. Set the contents for the first address (from Table B-5 for TJU16 magtape or from 
Table B-6 for TMll magtape) in the switch register. 

5. Lift the DEP switch. The computer automatically advances to the next address. 

6. Set the contents for the next address (from Table B-5 or B-6) in the switch 
register. 

7. Lift the DEP switch. 

8. Repeat steps 6 and 7 until you have deposited all the instructions. 

Table B-5: TJU16 Bootstrap Loader 
Address Contents 



001000 


012700 


001002 


172440 


001004 


012710 


001006 


000021 
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Table B-5 (Cont.): TJU16 Bootstrap Loader 



Address 



Contents 



001010 


012760 


001012 


001300 


001014 


000032 


001016 


012760 


001020 


177777 


001022 


000006 


001024 


012720 


001026 


000031 


001030 


105760 


001032 


000010 


001034 


100375 


001036 


012710 


001040 


177000 


001042 


012740 


001044 


000071 


001046 


032710 


001050 


100200 


001052 


001775 


001054 


100007 


001056 


022760 


001060 


001000 


001062 


000014 


001064 


001403 


001066 


000005 


001070 


000167 


001072 


177704 


001074 


005007 



Table B-6: TM11 Bootstrap Loader 



Address 



Contents 



010000 


012700 


010002 


172524 


010004 


005310 


010006 


012740 


010010 


060011 


010012 


105710 


010014 


100376 


010016 


005710 


010020 


100767 


010022 


012710 


010024 


060003 


010026 


105710 


010030 


100376 


010032 


005710 
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Table B-6 (Cont.): TM11 Bootstrap Loader 



Address Contents 



010034 100777 
010036 005007 



Now, verify that you deposited the bootstrap loader properly. 

1. Set the first address, 001000 or 010000, in the switch register. 

2. Press the LOAD ADDR switch. 

3. Press the EXAM switch to display the contents of that address in the data 
register. 

4. Compare the value in the data register with the value for that address in Table 
B-5 or B-6. 

5. If the values are the same, press EXAM again to display the contents of the 
next address. If the values are not the same, repeat the entire procedure for 
depositing the bootstrap. Verify the contents of all the addresses in this way. If 
any instruction is incorrect, repeat the entire deposit procedure. 

Once you have correctly deposited the bootstrap in memory, start the computer as 
follows: 

1. If the magtape is not positioned at the load point, rewind the magtape manually. 

2. Set the starting address, 001000 or 010000, in the switch register. 

3. Press the LOAD ADDR switch. 

4. Set the ENABLE/HALT switch to ENABLE. 

5. Press the START switch. 

B.6 Loading the RK06/RK07 DECpack Bootstrap 

Deposit the basic RK06 or RK07 disk bootstrap loader in memory as follows: 

1. Set the ENABLE/HALT switch to HALT. 

2. Set the first address, 001000, in the switch register (see Table B-7). 

3. Press the LOAD ADDR switch. 

4. Set the contents for the first address (from Table B-7) in the switch register. 

5. Lift the DEP switch. The computer automatically advances to the next address. 

6. Set the contents for the next address (from Table B-7) in the switch register. 

7. Lift the DEP switch. 

8. Repeat steps 6 and 7 until you have deposited all the instructions. 
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Table B-7: RK06/RK07 Bootstrap Loader 



Address 



Contents RK06 



Contents RK07 



001000 
001002 
001004 
001006 
001010 
001012 
001014 
001016 
001020 
001022 
001024 
001026 
001030 
001032 
001034 
001036 



012701 
177440 
012711 
000003 
032711 
100200 
001775 
012761 
177400 
000002 
012711 
000021 
032711 
100200 
001775 
005007 



012701 
177440 
012711 
002003 
032711 
100200 
001775 
012761 
177400 
000002 
012711 
002021 
032711 
100200 
001775 
005007 



Now, verify that you deposited the bootstrap loader properly. 

1. Set the first address, 001000, in the switch register. 

2. Press the LOAD ADDR switch. 

3. Press the EXAM switch to display the contents of that address in the data 
register. 

4. Compare the value in the data register with the value for that address in 
Table B-7. 

5. If the values are the same, press EXAM again to display the contents of the 
next address. If the values are not the same, repeat the entire procedure for 
depositing the bootstrap. Verify the contents of all the addresses in this way. If 
any instruction is incorrect, repeat the entire deposit procedure. 

Once you have correctly deposited the bootstrap in memory, start the computer as 
follows: 

1. Set the starting address, 001000, in the switch register. 

2. Press the LOAD ADDR switch. 

3. Set the ENABLE/HALT switch to ENABLE. 

4. Press the START switch. 
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B.7 Loading the RL01/RL02 Disk Bootstrap 

Deposit the basic RL01/RL02 disk bootstrap loader in memory as follows: 

1. Set the ENABLE/HALT switch to HALT. 

2. Set the first address, 001000, in the switch register (see Table B-8). 

3. Press the LOAD ADDR switch. 

4. Set the contents for the first address (from Table B-8) in the switch register. 

5. Lift the DEP switch. The computer automatically advances to the next address. 

6. Set the contents for the next address (from Table B-8) in the switch register. 

7. Lift the DEP switch. 

8. Repeat steps 6 and 7 until you have deposited all the instructions. 

Table B-8: RL01/RL02 Bootstrap Loader 
Address Contents 



001000 


012701 


001002 


174400 


001004 


012761 


001006 


000013 


001010 


000004 


001012 


012711 


001014 


000004 


001016 


105711 


001020 


100376 


001022 


005061 


001024 


000002 


001026 


005061 


001030 


000004 


001032 


012761 


001034 


177400 


001036 


000006 


001040 


012711 


001042 


000014 


001044 


105711 


001046 


100376 


001050 


005007 



Now, verify that you deposited the bootstrap loader properly. 

1. Set the first address, 001000, in the switch register. 

2. Press the LOAD ADDR switch. 

3. Press the EXAM switch to display the contents of that address in the data 
register. 
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4. Compare the value in the data register with the value for that address in 
Table B-8. 

5. If the values are the same, press EXAM again to display the contents of the 
next address. If the values are not the same, repeat the entire procedure for 
depositing the bootstrap. Verify the contents of all the addresses in this way. If 
any instruction is incorrect, repeat the entire deposit procedure. 

Once you have correctly deposited the bootstrap in memory, start the computer as 
follows: 

1. Set the starting address, 001000, in the switch register. 

2. Press the LOAD ADDR switch. 

3. Set the ENABLE/HALT switch to ENABLE. 

4. Press the START switch. 

B.8 Loading the RX211 Bootstrap 

Deposit the basic RX211 bootstrap loader in memory as follows: 

1. Set the ENABLE/HALT switch to HALT. 

2. Set the first address, 002000, in the switch register (see Table B-9). 

3. Press the LOAD ADDR switch. 

4. Set the contents for the first address (from Table B-9) in the switch register. 

5. Lift the DEP switch. The computer automatically advances to the next address. 

6. Set the contents for the next address (from Table B-9) in the switch register. 

7. Lift the DEP switch. 

8. Repeat steps 6 and 7 until you have deposited all the instructions. 

Table B-9: RX211 Bootstrap Loader 
Address Contents 



002000 


012701 


002002 


177170 


002004 


012700 


002006 


100240 


002010 


005002 


002012 


012705 


002014 


000200 


002016 


012704 


002020 


000401 


002022 


012703 


002024 


177172 
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Table B-9 (Cont.): RX211 Bootstrap Loader 



Address 



Contents 



002026 


030011 


002030 


001776 


002032 


100440 


002034 


012711 


002036 


000407 


002040 


030011 


002042 


001776 


002044 


100433 


002046 


110413 


002050 


000304 


002052 


030011 


002054 


001776 


002056 


110413 


002060 


000304 


002062 


030011 


002064 


001776 


002066 


100422 


002070 


012711 


002072 


000403 


002074 


030011 


002076 


001776 


002100 


100415 


002102 


010513 


002104 


030011 


002106 


001776 


002110 


100411 


002112 


010213 


002114 


060502 


002116 


060502 


002120 


122424 


002122 


120427 


002124 


000007 


002126 


003737 


002130 


005000 


002132 


005007 


002134 


000000 
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Now verify that you deposited the bootstrap loader properly. 

1. Set the first address, 002000, in the switch register. 

2. Press the LOAD ADDR switch. 

3. Press the EXAM switch to display the contents of that address in the data 
register. 

4. Compare the value in the data register with the value for that address in 
Table B-9. 

5. If the values are the same, press EXAM again to display the contents of the 
next address. If the values are not the same, repeat the entire procedure for 
depositing the bootstrap. Verify the contents of all the addresses in this way. If 
any instruction is incorrect, repeat the entire deposit procedure. 

Once you have correctly deposited the bootstrap in memory, start the computer as 
follows: 

1. Set the starting address, 002000, in the switch register. 

2. Press the LOAD ADDR switch. 

3. Set the ENABLE/HALT switch to ENABLE. 

4. Press the START switch. 

B.9 Loading the TSV05 Bootstrap, Using MICRO-ODT 

Deposit the TSV05 bootstrap loader in memory as follows: 

1. Turn on your processor. If it is already on, halt it. 

2. At the console, type the first address in Table B-10 (7776) followed by a slash (/): 
me/ 

The system responds by printing the contents of address 7776 (represented below 
by xxxxxx) on the console: 

7776/ xxxxxx 

3. On the same line, type the first contents value in Table B-10 (46523) followed 
by a line feed. 

7776/ xxxxxx 46523 [lf] 

The system deposits the value you type and displays the next memory location. 

10000/ 

4. Type the contents for the next memory location (Table B-10) followed by a line 
feed. 

5. Repeat step 4 until you have deposited all the instructions. Then, press 
RETURN. 
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6. Finally, enable the processor (remove the halt condition) and type: 
lOOOOG 

The processor reads the software bootstrap from the magtape into memory. The 
system prints the following prompt when it is finished: 

MSBOOT V05.XX 
* 

7. Respond to the asterisk (*) as described in Chapter 8. 

Table B-10: TSV05 Bootstrap Loader 
Address Contents 



007776 


046523 


010000 


012701 


010002 


172522 


010004 


010102 


010006 


005000 


010010 


105711 


010012 


100376 


010014 


010704 


010016 


112737 


010020 


000200 


010022 


172523 


010024 


005242 


010026 


105711 


010030 


100376 


010032 


005711 


010034 


100761 


010036 


005007 



B.10 Loading the TSV05 Bootstrap, Using the Switch Register 

Deposit the TSV05 bootstrap loader in memory as follows: 

1. Set the ENABLE/HALT switch to HALT 

2. Set the first address in Table B-10, 7776, in the switch register. 

3. Press the LOAD ADDR switch. 

4. Set the contents for the first address (046523 from Table B-10) in the switch 
register. 

5. Lift the DEP switch. The computer automatically advances to the next address. 

6. Set the contents for the next address (from Table B-10) in the switch register. 

7. Lift the DEP switch. 

8. Repeat steps 6 and 7 until you have deposited all the instructions. 
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Now, verify that you deposited the bootstrap loader properly. 

1. Set the starting address, 007776, in the switch register. 

2. Press the LOAD ADDR switch. 

3. Press the EXAM switch to display the contents of that address in the data 
register. 

4. Compare the value in the data register with the contents value for that address 
in Table B-10. 

5. If the values are the same, press EXAM again to display the contents of the 
next address. If the values are not the same, repeat the entire procedure for 
depositing the bootstrap. Verify the contents of all addresses in this way. If any 
instruction is incorrect, repeat the entire deposit procedure. 

Once you have correctly deposited the bootstrap in memory, start the computer as 
follows: 

1. Set the starting address, 010000, in the switch register. 

2. Press the LOAD ADDR switch. 

3. Set the ENABLE/HALT switch to ENABLE. 

4. Press the START switch. 
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